HTTP API
RunScore
A human (or judge) score for a run or for a single message within a run.
Shape: object
| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
id |
no | string (uuid) |
The score’s identifier. | — |
tenantId |
yes | string |
The tenant. | — |
runId |
yes | string (uuid) |
The identifier of the run being scored. | — |
messageId |
no | string |
The identifier of the message being scored. If empty, the score belongs to the whole run. | — |
name |
yes | string |
The score’s stable, low-cardinality name — part of the uniqueness key. | — |
kind |
yes | RunScoreKind |
The shape of the value. | — |
value |
no | number (double) |
The numeric value: 0/1 for RunScoreKind.Binary, 1 to 5 for RunScoreKind.Stars, 0 to 100 for RunScoreKind.Numeric. | pattern `^-?(?:0\ |
textValue |
no | string |
The categorical value. Set only for a RunScoreKind.Categorical score. | — |
comment |
no | string |
A free-text comment. | — |
source |
yes | string |
The score’s source: human, api, or judge:{name}. |
— |
author |
no | string |
The actor who gave the score. null in an identity-less setup. |
— |
createdAt |
no | string (date-time) |
The creation/last-updated time. | — |
evaluatorVersion |
no | string |
The version of the component that produced this score, when one is known. | — |