ScoreAggregate
Count and average for scores grouped by name and source.
Usage profiles
| Usage | Fields and validation |
|---|---|
| In responses | View fields |
In responses
API JSON uses JSON field names (camelCase).
| Field | Type | Presence | Meaning |
|---|---|---|---|
name | string | Optional | Metric name shared by the aggregated scores. |
source | string (SCORE_SOURCE_JUDGE, SCORE_SOURCE_HUMAN, SCORE_SOURCE_USER, SCORE_SOURCE_HARNESS, SCORE_SOURCE_EVAL) or integer (int32) | Optional | Source classification reported for the evaluation score. |
count | string (int64) | Optional | Number of evaluation records represented by this group. Pattern: ^-?\d+$. |
average | number (double) or string (NaN, Infinity, -Infinity) | Optional | Average score value reported for the aggregate. |
Values of source
Platform classification of who produced an evaluation score; the provider source label preserves its original vocabulary.
| Value | No. | Form | Meaning |
|---|---|---|---|
SCORE_SOURCE_JUDGE | 1 | Canonical | A score produced by an automated judge. |
SCORE_SOURCE_HUMAN | 2 | Canonical | A score entered by a human reviewer through the annotation path. |
SCORE_SOURCE_USER | 3 | Canonical | Feedback supplied by an end user. |
SCORE_SOURCE_HARNESS | 4 | Canonical | A score written by an evaluation harness or another API-based producer. |
SCORE_SOURCE_EVAL | 5 | Canonical | A read-only score produced by the evaluation provider's managed evaluators; it cannot be written through the public score API. |
Where used
| Reference | Relationship |
|---|---|
| Get the eval overview | POST /api/v1/evals/get-overview |
| EvalOverview | Nested in model |
Download the public reference contract.
Document: DOC-API-MODEL-score-aggregate.