AI CompendiumA public chart of the language
Home / Evaluation / Eval Harness
Evaluation

Eval Harness

also called Harness

The scaffolding that runs your test cases and scores the results.

Definition

The code that feeds cases to the system, collects outputs and applies scoring — exact match, rubric, model judge or human. Usually a small purpose-built script plus a place to store results.

The valuable property is repeatability: the same suite, run the same way, compared over time. A spreadsheet of manual checks decays within a month.

Keep it boring and keep it runnable by anyone. The value is not sophistication, it is that a change can be scored in minutes by a person who did not write it. A harness that needs the author to run it is a harness that will be used once.

How people use it
Deciding how much to invest in tooling.
"We do not need a platform. A script, a JSONL of cases, and a score in CI covers ninety percent."
Worked example

Owning the whole environment

Evaluating a coding agent on multi-step tasks.

The grader has to inspect the resulting repository, not the final message: did the tests pass, is the file changed, did it avoid the protected directory. That is a different kind of assertion from single-turn output scoring, and it is where harness quality shows.

Sources
  • blogDemystifying evals for AI agents ↗Anthropic Engineering · 2026

    Gives working definitions for harness, task, trial, grader, transcript and outcome, and argues you must evaluate the model and harness together and judge final environment state, not just the last message.

  • docsLangSmith evaluation ↗LangChain docs · 2026

    Distinguishes offline evaluation on datasets from online monitoring of production traffic, and shows failing production traces being promoted into regression datasets.

Related terms