EvaluateChoose graders

Choose graders

⚠️
Preview — this feature is being built; the design below is the spec.

A grader turns an output into a score. Pick the cheapest grader that measures what you care about.

KindChecksCostGood for
exact_matchOutput equals ideal after trimmingFreeLabels, ids, yes/no
containsOutput contains (or does not contain) given stringsFreeRequired disclaimers, banned phrases
regexOutput matches a patternFreeFormats such as order numbers, dates
json_schemaOutput parses and fits a schemaFreeStructured output, tool arguments
similarityEmbedding similarity to ideal above a thresholdEmbedding tokensParaphrase-tolerant factual answers
model_rubricA model scores the output 1 to 5 against your rubricModel tokensTone, completeness, faithfulness, reasoning

Combine them

A run can apply up to five graders; an item passes only if all pass. A typical support set uses:

  • json_schema when the reply must be structured,
  • contains with not: ["guarantee", "100%"] for words legal does not allow,
  • model_rubric for overall quality.

Code graders catch hard failures for free; the rubric judges what code cannot.

When to trust a model grader

Model graders are only as good as their rubric and calibration. Before relying on one, grade 30 to 50 outputs by hand, run the grader on the same outputs with Test a grader, and compare. Agreement of 85% or more on pass/fail is a reasonable bar. Where they disagree, read both judgments; usually the rubric was ambiguous. See Write rubrics.

Grader independence

Use a different model, or at least a different prompt, for grading than for generating, and prefer a stronger model for grading (Amara Deep is a common choice). A model grading its own outputs with the instructions it was given tends to agree with itself.

Was this page helpful?