DatasetItem
One evaluation input with its expected output and source trace references.
Usage profiles
| Usage | Fields and validation |
|---|---|
| In responses | View fields |
In responses
API JSON uses JSON field names (camelCase).
| Field | Type | Presence | Meaning |
|---|---|---|---|
itemId | string | Optional | Identifier of the dataset or annotation queue item. |
datasetId | string | Optional | Identifier of the evaluation dataset. |
datasetName | string | Optional | Name of the evaluation dataset. |
inputJson | string | Optional | Evaluation input serialized as JSON. |
expectedOutputJson | string | Optional | Expected output serialized as JSON. Empty until a curator supplies an expected result. |
metadataJson | string | Optional | Additional attributes serialized as a JSON object. |
sourceTraceId | string | Optional | Identifier of the trace from which the dataset item originated. |
sourceObservationId | string | Optional | Identifier of the observation from which the dataset item originated. |
status | string (DATASET_ITEM_STATUS_ACTIVE, DATASET_ITEM_STATUS_ARCHIVED) or integer (int32) | Optional | State controlling whether the dataset item participates in evaluation. |
createdAt | string (date-time) | Optional | Time when this record was created. |
updatedAt | string (date-time) | Optional | Time when this record was last updated. |
Values of status
Whether a dataset item is active or retained as archived content.
| Value | No. | Form | Meaning |
|---|---|---|---|
DATASET_ITEM_STATUS_ACTIVE | 1 | Canonical | The dataset item is active. |
DATASET_ITEM_STATUS_ARCHIVED | 2 | Canonical | The dataset item is archived and retained as historical content. |
Where used
| Reference | Relationship |
|---|---|
| List dataset items | POST /api/v1/evals/list-dataset-items |
Download the public reference contract.
Document: DOC-API-MODEL-dataset-item.