CallTrace
The trace of a finalized Call: its segments in order, and the content classes the request included.
An object with 17 fields.
Fields
| Field | Type | Required | Description |
|---|---|---|---|
agent_id | AgentId | yes | |
agent_version | integer | yes | |
analyses | array of TraceAnalysisRef | no | The post-call analyses of the Call, beside the end segment (1.57.0). Absent from an api older than 1.57.0; a reader treats its absence as none. |
call_id | CallId | yes | |
capture | TraceCapture | yes | |
cost_basis | TraceCostBasis | no | Where the segments' cost comes from (1.57.0). Absent from an api older than 1.57.0, whose cost is the estimate. |
envelopes | array of TraceEnvelope | yes | The audio envelope of each lane the worker sent, at most one per lane; always present and empty when the worker sent none (the flag diagnostics.audio_envelope was off, or the Call predates 1.13.0). Not a content class: a loudness series is a measurement (workspace ADR 0068), so no include is needed. |
epoch_at | Timestamp | yes | The wall-clock instant of the trace epoch; for display and api marks only. |
model_io | array of ModelIoItem | no | The captured model messages, empty when the capture was standard; present only with include=model_io. |
model_io_dropped | integer | no | Messages the worker dropped at its capture bound; present with model_io. |
object | "call_trace" | yes | |
recording_offset_ms | integer or null | no | The trace-epoch offset of the recording's first sample (1.57.0), so replay aligns audio and marks; null when the Call has no recording. Absent from an api older than 1.57.0; a reader treats its absence as null. |
reveal_grant_id | RevealGrantId or null | no | The reveal grant that let this read include a class the reader's role has as reveal (1.57.0); null when no grant was used. Absent from an api older than 1.57.0. |
segments | array of TraceSegment | yes | |
tool_payloads | array of TracePayloadItem | no | The Tool payloads in order; present only with include=tool_payloads (1.57.0). |
tool_payloads_outside_turns | integer | no | The Tool invocations outside every Turn, in the setup or end segment, whose payloads no item answers (1.59.0); present with include=tool_payloads, and a reader treats its absence as 0. |
transcripts | array of TranscriptTurn | no | The text of each Turn; present only with include=transcripts. |
Used by
The operations whose parameters, request body or responses name this shape directly.