Section ID:
DOC-API-MODEL-schema-1js2bf073d#overview
EvalOverview
Aggregated trace, score, latency, and profile metrics for an evaluation window.
Meaning and usage
Section ID: DOC-API-MODEL-schema-1js2bf073d#meaning
See the definition above.
Usage profiles
Section ID: DOC-API-MODEL-schema-1js2bf073d#fields
| Usage | Fields and validation |
|---|---|
| In responses | View fields |
In responses
Section ID: DOC-API-MODEL-schema-1js2bf073d#response
API JSON uses JSON field names (camelCase).
| Field | Type | Presence | Meaning |
|---|---|---|---|
Section ID: DOC-API-MODEL-schema-1js2bf073d#field-totaltracesSection ID: DOC-API-MODEL-schema-1js2bf073d#response-field-totaltracestotalTraces | string (int64) | Optional | Total trace count reported for the selected evaluation window. Pattern: ^-?\d+$. |
Section ID: DOC-API-MODEL-schema-1js2bf073d#field-tracesbynameSection ID: DOC-API-MODEL-schema-1js2bf073d#response-field-tracesbynametracesByName | Array of NamedCount | Optional | Trace counts grouped by trace name. |
Section ID: DOC-API-MODEL-schema-1js2bf073d#field-tracesovertimeSection ID: DOC-API-MODEL-schema-1js2bf073d#response-field-tracesovertimetracesOverTime | Array of TimeSeriesPoint | Optional | Trace counts grouped into time buckets. |
Section ID: DOC-API-MODEL-schema-1js2bf073d#field-observationsbylevelSection ID: DOC-API-MODEL-schema-1js2bf073d#response-field-observationsbylevelobservationsByLevel | Array of TimeSeriesPoint | Optional | Observation counts grouped by reported log level. |
Section ID: DOC-API-MODEL-schema-1js2bf073d#field-scoresSection ID: DOC-API-MODEL-schema-1js2bf073d#response-field-scoresscores | Array of ScoreAggregate | Optional | Score aggregates grouped separately by metric name and source. |
Section ID: DOC-API-MODEL-schema-1js2bf073d#field-scoremovingaverageSection ID: DOC-API-MODEL-schema-1js2bf073d#response-field-scoremovingaveragescoreMovingAverage | Array of TimeSeriesPoint | Optional | Moving-average score series returned for the selected window. |
Section ID: DOC-API-MODEL-schema-1js2bf073d#field-scoredtraceratioSection ID: DOC-API-MODEL-schema-1js2bf073d#response-field-scoredtraceratioscoredTraceRatio | number (double) or string (NaN, Infinity, -Infinity) | Optional | Coverage card: share of traces carrying any score, and the annotated count. |
Section ID: DOC-API-MODEL-schema-1js2bf073d#field-annotatedtracecountSection ID: DOC-API-MODEL-schema-1js2bf073d#response-field-annotatedtracecountannotatedTraceCount | string (int64) | Optional | Number of traces reported to have annotations in the selected window. Pattern: ^-?\d+$. |
Section ID: DOC-API-MODEL-schema-1js2bf073d#field-byprofileSection ID: DOC-API-MODEL-schema-1js2bf073d#response-field-byprofilebyProfile | Array of ProfileQualityRow | Optional | Evaluation metrics grouped by agent profile. |
Section ID: DOC-API-MODEL-schema-1js2bf073d#field-latencypercentilesSection ID: DOC-API-MODEL-schema-1js2bf073d#response-field-latencypercentileslatencyPercentiles | Array of LatencyPercentileRow | Optional | Latency percentile summaries grouped by trace name. |
Section ID: DOC-API-MODEL-schema-1js2bf073d#field-recentlowscoresSection ID: DOC-API-MODEL-schema-1js2bf073d#response-field-recentlowscoresrecentLowScores | Array of Score | Optional | Recent scores selected by the overview’s low-score query. |
Where used
Section ID: DOC-API-MODEL-schema-1js2bf073d#where-used
| Reference | Relationship |
|---|---|
| Get the eval overview | POST /api/v1/evals/get-overview |
Download the public reference contract.
Document ID: DOC-API-MODEL-schema-1js2bf073d