Create Evaluator Result

View as Markdown

Path parameters

workspacestringRequired

Request

This endpoint expects an object.
span_idstringRequired

Target span id. Not validated against existing spans (loose target policy).

session_idstringRequired

Session id the target span belongs to. Denormalized so session-scoped reads stay fast.

namestringRequired

Evaluator / metric identity (e.g. ‘faithfulness/v1’).

data_typeenumRequired

Discriminator for which of value / string_value carries the payload.

Allowed values:
valuedoubleOptional

Numeric value. Required when data_type is NUMERIC or BOOLEAN (0|1).

string_valuestringOptional

String value. Required when data_type is CATEGORICAL or TEXT.

statusenumOptionalDefaults to SCORED

SCORED when the evaluator produced a value; FAILED when it ran but could not score this target (no value or string_value; put the reason in comment). Rollups count a FAILED result as a failed attempt instead of inferring failure from a missing row.

Allowed values:
commentstringOptional

Free-text rationale or explanation.

Response

Successful Response
evaluator_result_idstring
span_idstring
session_idstring
workspacestring
namestring
data_typeenum
Allowed values:
created_atdatetime
ingested_atdatetime
valuedoubleOptional
string_valuestringOptional
statusenumOptionalDefaults to SCORED

Whether the evaluator produced a value for its target.

A FAILED result carries no value: the evaluator ran and could not score (judge unreachable, unparseable output, errored trial). Rollups count it as a failed attempt rather than inferring failure from the absence of a row.

Allowed values:
commentstringOptional
created_bystringOptional

Errors

422
Unprocessable Entity Error