VocalDocscontracts 1.65.0

PromptEvalRun

A run of an evaluation suite (1.55.0): the candidate and baseline, the per-arm pass rates with intervals and the deterministic facts, the judge and the cost lines. Ids, counts and rates only; the rationales are verdict content.

An object with 24 fields.

Fields

FieldTypeRequiredDescription
advisorybooleanyesTrue when the judged results gate nothing, because the judge is not checked against human labels (section 9.1 rule 5); true for every run of 1.55.0. From 1.63.0 false only when the suite's latest calibration met its target with the run's judge (promptEvalJudgeAdvisory), and false for a run that judged nothing.
agent_idAgentIdyes
baselinePromptEvalRunTarget or nullyes
by_familyarray or nullnoOne entry per evaluated family and arm (1.63.0), once completed; null before. Absent from an api before 1.63.0.
by_itemarray or nullnoOne entry per scenario, rubric item and arm (1.63.0), once completed; null before. Absent from an api before 1.63.0.
candidatePromptEvalRunTargetyes
cost_linesarray of PromptEvalCostLineyes
created_atTimestampyes
created_byActorRefyes
error_codestring or nullyes
finished_atTimestamp or nullyes
gatePromptEvalGateOutcome or nullnoHow the run fares against its suite's publish gate (1.63.0), once completed; null for a suite with no gate and before completion. Absent from an api before 1.63.0.
idPromptEvalRunIdyes
job_idJobIdyesThe prompt.evaluation job that runs it.
judgeStageRef or nullyesThe judge the run used; null with none.
model_familiesarray of ModelFamilynoThe model families the run evaluated (1.63.0): the request's model_families, or the family of the chain's primary. Absent from an api before 1.63.0.
object"prompt_eval_run"yes
repetitionsintegeryes
scenario_countintegeryes
started_atTimestamp or nullyes
statusPromptEvalRunStatusyes
suite_idPromptEvalSuiteIdyes
suite_revisionintegeryes
summaryarray or nullyesOne entry per arm, the candidate first, once completed; null before.

Used by

The operations whose parameters, request body or responses name this shape directly.