TraceSummary
Evaluation summary for a conversation turn, including its recorded conversation, message and profile attribution.
Usage profiles
| Usage | Fields and validation |
|---|---|
| In responses | View fields |
In responses
API JSON uses JSON field names (camelCase).
| Field | Type | Presence | Meaning |
|---|---|---|---|
traceId | string | Optional | Identifier of the evaluation trace. |
name | string | Optional | Name recorded for the evaluation trace. |
timestamp | string (date-time) | Optional | Timestamp associated with the conversation message or event. |
inputJson | string | Optional | Evaluation input serialized as JSON. |
outputJson | string | Optional | Evaluation output serialized as JSON. |
latencySeconds | number (double) or string (NaN, Infinity, -Infinity) | Optional | Elapsed observation latency, in seconds. |
totalCost | number (double) or string (NaN, Infinity, -Infinity) | Optional | Total cost reported for the evaluated generation or aggregate. |
environment | string | Optional | Environment label attached to the evaluation record. |
tags | Array of string | Optional | Labels associated with the resource for organization or filtering. |
metadataJson | string | Optional | Additional attributes serialized as a JSON object. |
bookmarked | boolean | Optional | Whether the evaluation object is bookmarked. |
version | string | Optional | Version of the resource represented by this message. |
release | string | Optional | Application release identifier attached to the trace. |
userId | string | Optional | Identifier of the user associated with the operation. |
sessionId | string | Optional | Identifier of the evaluation session grouping related traces. |
observationCount | integer (int32) | Optional | Number of observations reported for the evaluation object. Minimum: -2147483648. Maximum: 2147483647. |
conversationId | string | Optional | Identifier of the conversation associated with the trace. |
sourceUserMessageId | string | Optional | Identifier of the user message that opened the evaluated generation turn. |
profileId | string | Optional | Identifier of the agent profile associated with the generation. |
configHash | string | Optional | Fingerprint of the profile ID, model and resolved prompt hash used to group evaluation results. Other settings are excluded; this is not an immutable profile revision. |
inputTokens | string (int64) | Optional | Input-token usage reported for the evaluated generation. Pattern: ^-?\d+$. |
outputTokens | string (int64) | Optional | Output-token usage reported for the evaluated generation. Pattern: ^-?\d+$. |
totalTokens | string (int64) | Optional | Total token usage reported for the evaluated generation or aggregate. Pattern: ^-?\d+$. |
errorCount | integer (int32) | Optional | Number of observations reported at error level. Minimum: -2147483648. Maximum: 2147483647. |
warningCount | integer (int32) | Optional | Number of observations reported at warning level. Minimum: -2147483648. Maximum: 2147483647. |
defaultCount | integer (int32) | Optional | Number of observations reported at the default level. Minimum: -2147483648. Maximum: 2147483647. |
debugCount | integer (int32) | Optional | Number of observations reported at debug level. Minimum: -2147483648. Maximum: 2147483647. |
scores | Array of Score | Optional | Evaluation scores returned for the selected objects or query. |
commentCount | integer (int32) | Optional | Number of comments reported on the evaluation object. Minimum: -2147483648. Maximum: 2147483647. |
Where used
| Reference | Relationship |
|---|---|
| Get a session | POST /api/v1/evals/get-session |
| Get a trace | POST /api/v1/evals/get-trace |
| List traces | POST /api/v1/evals/list-traces |
| SessionDetail | Nested in model |
| TraceDetail | Nested in model |
Download the public reference contract.
Document: DOC-API-MODEL-trace-summary.