Output types & scoring

Every value an eval can return, and the settings that turn scores into verdicts

What a result carries

Every evaluation run produces a result for each row, span, or test input it scores.

PartWhat it isWhen present
ValueThe verdict, score, or label, shaped by the template’s output type (the three types below)Always
ReasonA plain-language explanation of the verdict from the evaluator modelLLM-as-Judge and Agent Evaluator evals; Code Evals have no evaluator model, so no reason

The reason is worth reading before anything else when a result surprises you: instead of re-reviewing the response manually, you read why the evaluator model called it the way it did.

The three output types

Whatever shape the value takes, every result resolves to an underlying score between 0 and 1. The two scoring settings below act on that number.

Output typeThe valueHow it becomes a verdictTypical templates
Pass/FailPass or failThe score checked against the pass thresholdToxicity, PII detection, format checks
PercentageA graded score, shown as a percentagePasses when the score clears the thresholdGroundedness, relevance, completeness
Deterministic choicesOne label from the set the template definesEach label carries a score via choice scoresTone, language, intent

Built-in templates ship with their output type fixed; a custom eval picks one when you create it.

Scoring settings

Two template settings turn a raw output into a verdict you can gate on:

SettingWhat it doesDefault
Pass thresholdA score at or above the threshold counts as a passThe midpoint, 0.5
Choice scoresMaps each choice label to a score, for example {"Yes": 1.0, "No": 0.0}, so categorical results still roll up into numbersSet per template

Both live in the eval’s configuration: set them when you create a custom eval or attach one to a run.

Aggregates

A single result judges one response; the platform also rolls results up per eval:

AggregateWhat it tells youApplies to
Pass rateThe share of scored rows that passedPass/Fail outputs
Average scoreThe mean score across rowsPercentage outputs

Aggregates are tracked per template per run, so the same eval gives you comparable quality numbers across datasets, runs, and template versions.

Where results land

SurfaceHow results show
Datasets and experimentsA result column per eval, one value per row, with an optional reason column alongside
TracesA span’s eval results in the trace detail view in Observe, with the flagged input when error localization ran
PlaygroundValue and reason per test, as soon as the run finishes
CodeThe SDK returns the same result as an object; see SDK & API

Keep exploring

Was this page helpful?

Questions & Discussion