Perception Analysis Event

{
  "message_type": "conversation",
  "event_type": "conversation.perception_analysis",
  "seq": 128,
  "conversation_id": "your-conversation-id",
  "inference_id": "550e8400-e29b-41d4-a716-446655440000",
  "turn_idx": 3,
  "properties": {
    "analysis": "Bulleted summary of recent visual / ambient observations."
  }
}

Outbound: After the conversation ends and the replica has summarized what was visually observed, Tavus sends that full perception analysis (Raven-1 personas).

Requires Raven-style perception; see Perception — end-of-call perception analysis.

message_type

string

conversation for conversation-layer app messages.

Example:

"conversation"

event_type

string

conversation.perception_analysis.

Example:

"conversation.perception_analysis"

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

Present when the frame carries a UUID id.

Example:

"550e8400-e29b-41d4-a716-446655440000"

turn_idx

integer

Turn index; increments when conversation.respond is processed. Groups utterances, tool calls, and speaking-state events for the same turn. See Event ordering and turn tracking.

Example:

3

properties

object

Omitted when empty.

Show child attributes

Perception Tool Call Event CVI App Quickstart

⌘I