{
"message_type": "conversation",
"event_type": "conversation.agent_update",
"seq": 312,
"conversation_id": "your-conversation-id",
"inference_id": "550e8400-e29b-41d4-a716-446655440000",
"properties": {
"task_id": "call_abc123",
"type": "update",
"title": "Two open PRs",
"text": "Found two open pull requests on the billing repo, checking which one is stale."
}
}Agent Update Event
Outbound: Tavus relays an update the background agent chose to give the user.
Emitted only when layers.mcp.spoken_updates or layers.mcp.visual_updates is all. The background agent decides when something is worth telling the user before the answer and writes it as a card: a short title and a one-sentence text. This is the same update the PAL speaks and shows on Magic Canvas, so a client that renders it matches the call. Tool calls are not reported. The outcome always arrives in conversation.agent_stop, never here.
Conversations recorded before this change carry type: tool (with tool and args) or type: narration updates instead.
conversation for conversation-layer app messages.
"conversation"
conversation.agent_update.
"conversation.agent_update"
Unix timestamp (seconds since epoch) indicating when this event was created. Use this to build timestamped transcripts or reconstruct the timeline of a conversation.
1746000000.123
Monotonic per event; a higher seq was emitted later. Use with turn_idx as in Event ordering and turn tracking.
42
The unique identifier for the conversation.
"c123456"
Unique identifier for the utterance that triggered the delegation.
"83294d9f-8306-491b-a284-791f56c8383f"
One update the agent gave the user: a card with a title and a text.
Show child attributes
Show child attributes