SessionSummary
Aggregated trace, usage, and score information for an evaluation session.
Usage profiles
| Usage | Fields and validation |
|---|---|
| In responses | View fields |
In responses
API JSON uses JSON field names (camelCase).
| Field | Type | Presence | Meaning |
|---|---|---|---|
sessionId | string | Optional | Identifier of the evaluation session grouping related traces. |
createdAt | string (date-time) | Optional | Time when this record was created. |
durationSeconds | number (double) or string (NaN, Infinity, -Infinity) | Optional | Elapsed session duration, in seconds. |
environment | string | Optional | Environment label attached to the evaluation record. |
userIds | Array of string | Optional | Identifiers of the users selected by the operation. |
traceCount | integer (int32) | Optional | Number of traces represented by this summary or group. Minimum: -2147483648. Maximum: 2147483647. |
totalCost | number (double) or string (NaN, Infinity, -Infinity) | Optional | Total cost reported for the evaluated generation or aggregate. |
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+$. |
traceTags | Array of string | Optional | Labels collected from the session’s evaluation traces. |
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. |
metadataJson | string | Optional | Additional attributes serialized as a JSON object. |
bookmarked | boolean | Optional | Whether the evaluation object is bookmarked. |
conversationIds | Array of string | Optional | Conversation identifiers observed on the session’s traces; a session may span multiple conversations. |
Where used
| Reference | Relationship |
|---|---|
| Get a session | POST /api/v1/evals/get-session |
| List sessions | POST /api/v1/evals/list-sessions |
| SessionDetail | Nested in model |
Download the public reference contract.
Document: DOC-API-MODEL-session-summary.