Skip to main content

Outbound: Tavus signals that a background task has started running on the PAL's MCP connectors.

Emitted when the PAL delegates work with the delegate_background_task tool. Several tasks can run at once, so every event in this family is keyed by task_id - the same value the dispatching conversation.tool_call carried as tool_call_id.

Key the task lifecycle on agent_start / conversation.agent_stop, not on conversation.tool_call: a task that fails to dispatch emits its stop before that message reaches you.

Configure connectors: MCP connectors.

message_type
string

conversation for conversation-layer app messages.

Example:

"conversation"

event_type
string

conversation.agent_start.

Example:

"conversation.agent_start"

timestamp
number

Unix timestamp (seconds since epoch) indicating when this event was created. Use this to build timestamped transcripts or reconstruct the timeline of a conversation.

Example:

1746000000.123

seq
integer

Monotonic per event; a higher seq was emitted later. Use with turn_idx as in Event ordering and turn tracking.

Example:

42

conversation_id
string

The unique identifier for the conversation.

Example:

"c123456"

inference_id
string

Unique identifier for the utterance that triggered the delegation.

Example:

"83294d9f-8306-491b-a284-791f56c8383f"

properties
object

Opens the lifecycle of one background task. A task that is turned away - bad arguments, or too many already running - still emits this, immediately followed by conversation.agent_stop, so every stop has a matching start.