DatasetRunItem
One item of a dataset run: which dataset item was executed, and the trace it produced.
Usage profiles
| Usage | Fields and validation |
|---|---|
| In requests | View fields |
In requests
API JSON uses JSON field names (camelCase).
| Field | Type | Presence | Meaning |
|---|---|---|---|
datasetItemId | string | Required in requests | Identifier of the dataset item used by this evaluation run. Minimum length: 1. |
traceId | string | Required in requests | Identifier of the evaluation trace. Minimum length: 1. |
observationId | string | Optional | Optional: pin the run to one observation inside the trace rather than the whole turn, for a harness that scores a single generation. |
Request validation
These rules apply when this value is supplied in a request. Request validation does not guarantee that response fields are present or satisfy the same rules.
| Applies to | Rule | Requirement |
|---|---|---|
datasetItemId | Minimum length | 1 |
traceId | Minimum length | 1 |
Where used
| Reference | Relationship |
|---|---|
| Record a dataset run | POST /api/v1/evals/record-dataset-run |
Download the public reference contract.
Document: DOC-API-MODEL-dataset-run-item.