Concepts / Evaluating the Evaluation Pipeline

Evaluating the Evaluation Pipeline

An evaluation pipeline must be iterated on as user needs and behaviors change, since fixed criteria can stop measuring what matters.

  • Programming

The Fixed Measuring Stick Problem

Many people who build an evaluation for an AI application treat it like a finished product. They write the criteria, design a scoring rubric, choose a handful of examples, and then assume the job is done. The evaluation becomes a fixed measuring stick that never needs recalibration. This is a common and understandable belief, but it breaks down quickly once the application is used by real people.

This lesson follows one idea through the whole pipeline: the evaluation is itself something you must keep checking. You will trace how a change in user behavior moves through the evaluation, why the criteria, rubric, and examples may each need revision, and why revision has to be balanced against the need for consistent results.

Why the Evaluation Has to Change

The reason the evaluation has to change follows directly from what it is for. An evaluation exists to tell you how well your application is doing against the goals that matter. When the people using the application shift what they need, or start interacting with it in new ways, the goals that matter shift too.

The evaluation criteria describe what counts as good behavior. If users start caring about something the criteria never mention, or stop caring about something the criteria still reward, the criteria no longer describe what users care about. The correction is to iterate: adjust the criteria to match the current situation rather than holding on to the criteria you wrote at the start.

User behavior shiftsCriteria go stalePipeline is revisedcriteria, rubric, orexamplesEvaluation re-runResults measure whatmattersshifts what users needtriggers revisionnew configurationscores reflect current goalsnext change in use
After user behavior shifts, how does the pipeline cycle back to measure what matters again?

Read the loop as a cycle, not a one-time fix. Each pass through it asks the same question: do the current criteria still describe what counts as good for the people using the application today? Whenever the answer is no, the pipeline moves on to revision and then measures again.

The Three Parts That Can Be Revised

Iteration has three concrete levers. Each can be pulled independently, and a single change in user needs may call for several of them at once. The diagram below shows how the three parts sit inside the pipeline. Every part feeds the AI judges, and the judges' scores end up in the results.

Evaluation pipelineEvaluation criteriawhat is judgedAI judgesScores in resultsScoring rubrichow judgments map to scoresExampleshow judges interpret thecriteriacontainscontainscontainsfeedsfeedsfeedsproduces
Which of the three parts must be updated when the judge stops measuring what matters?

Because changes to any of the three parts pass through the judges and show up in the results, a change to one part changes the outputs. This is exactly why changes need to be managed carefully. The three parts are examined one at a time below.

Tracing a Revision Through the Pipeline

Worked example

A support assistant whose users start asking for brief answers

An evaluation was written for a support assistant. The criteria reward accurate, complete answers. Over several weeks, users begin asking the assistant for quick, short replies, and they complain when answers are long. The team must decide what to revise.

  1. 1
    Check the criteria first

    The criteria describe what counts as good. They reward completeness but say nothing about length or brevity, so they no longer describe what these users care about. The criteria need an update, such as adding brevity as something that is judged.

  2. 2
    Update the rubric to match

    A new criterion needs a way to become a score. The rubric is revised so that a reply that answers the question in a few sentences maps to a high brevity score, and a reply padded with unnecessary detail maps to a lower one.

  3. 3
    Revise the examples

    The judges interpret the criteria through examples. The example set is updated to include short replies that are accurate and helpful, so the judges learn what a good short answer looks like rather than defaulting to rewarding long answers.

  4. 4
    Record the change and re-run

    Before re-running, the revised criteria, rubric version, and example set are logged. The evaluation is then re-run so the results reflect current user goals.

Result

One shift in user behavior moved through all three levers. The pipeline was revised as a whole, and the new results can be read against the current goals.

Notice that the team did not discard the original accuracy criterion. Iteration adjusts the criteria to match the current situation, and that can mean adding new criteria alongside existing ones. The aim is an evaluation that reflects what users care about now.

Why Consistency Still Matters

Revision alone is not enough. Iteration has to coexist with a reasonable level of consistency. An evaluation that changes constantly cannot reliably guide application development, because the people reading its results cannot tell what caused a difference between rounds.

Consider what a score change can mean. It might come from a change in the application, which is what you want to learn about. It might come from a change in the evaluation itself, such as a new rubric or a different judge configuration. If both happened at once and nothing was recorded, the score change cannot be attributed to either one.

Rubric changedsame judgeScores shiftcause is ambiguousOnly judge variedsame rubric and examplesScores shiftchange traced to the judgeresults comparedresults compared
How do results differ when the rubric changed versus when only the judge varied, and which comparison is valid?

In the left column, the rubric and the scores both changed, so a shift in results cannot be assigned to one cause. In the right column, the rubric and examples were held fixed and only the judge changed, so the difference can be traced to the judge. This is the sense in which a comparison is valid: you know which variable differed, and everything else you could have logged is the same.

Experiment Tracking as a Record

The practical tool for keeping revisions interpretable is experiment tracking. Experiment tracking means logging every variable that could change during an evaluation process. When you compare two rounds of evaluation, the log shows exactly what differed between them. Without a record, you are left guessing whether a difference came from the application, the data, the rubric, or the judge's own configuration.

VariableWhat it recordsWhy it matters for a reproducible result
Evaluation dataThe examples and inputs used in the runChanging examples changes how judges interpret the criteria
Scoring rubricThe version of the rubric that maps judgments to scoresThe same judgment can produce a different score under a different rubric
Judge prompt and sampling configurationThe prompt and sampling settings used for the AI judgesJudge settings can shift scores even when everything else is held fixed
Judge modelWhich model served as the judgeA different judge can produce different scores from identical inputs
Scores and dateThe results of the run and when it was performedLets a result be matched back to the exact inputs that produced it

Variables to log with each AI judge evaluation run. The source names evaluation data, the rubric, and the prompt and sampling configurations; the judge model, scores, and date are recorded alongside them so each run can be reproduced.

Mistakes in Maintaining an Evaluation

  • Common mistake

    Treating the evaluation as a finished product

    What it looks like

    The team writes the criteria at launch and never revisits them, even after users begin asking for something the criteria do not mention.

    Why it fails

    The evaluation exists to measure goals that matter, and those goals shift when users shift what they need.

    Do this instead

    Check the criteria whenever user needs or behaviors change, and revise them to match the current situation.

  • Common mistake

    Changing the criteria, rubric, and examples all at once without a record

    What it looks like

    A new rubric, a new example set, and a new judge model are introduced in the same round, and the scores move.

    Why it fails

    A score change can no longer be attributed to the application, because several evaluation variables changed together and were not logged.

    Do this instead

    Log every variable that changes, and make changes in a way that lets you tell which one caused a difference.

  • Common mistake

    Revising the evaluation constantly

    Why it fails

    An evaluation that keeps shifting cannot serve as a reliable guide for deciding what to improve in the application.

    Do this instead

    Balance revision against consistency, so that results remain comparable across rounds.

  • Common mistake

    Logging only the scores

    Why it fails

    Scores alone do not show what produced them, so two rounds with different scores cannot be explained.

Predicting a Revision's Effect

What do you think happens?

Users stop complaining about accuracy and start complaining that answers are too long. Which part of the pipeline should you check first?

  • The rubric, because it sets the numbers

  • The evaluation criteria, because they define what counts as good

  • The judge model, because it always causes the problem

Reveal answer
Answer:

The evaluation criteria, because they define what counts as good behavior.

The criteria describe what users care about. If users now care about brevity and the criteria do not mention it, the criteria are the first thing to revise. The rubric and examples may then need updating to support the revised criteria.

MEDIUM

A team's evaluation of a writing assistant was built around one criterion, factual correctness. Their users now ask for a friendlier tone. Describe the revision you would make to each of the three parts: criteria, rubric, and examples. Then list at least three variables you would log before re-running the evaluation.

Hints
  • Start with the criteria, since they define what is being judged.
  • Think about how a tone judgment would be turned into a score, which is the rubric's job.
  • Think about what examples would show the judges a friendly but correct response.

Summary of the Revision Cycle

  1. 1
    An evaluation pipeline must be iterated on as user needs and behaviors change, because fixed criteria can stop measuring what matters.
  2. 2
    Iteration has three levers: the evaluation criteria, the scoring rubric, and the examples. Each can be changed independently, and one change in user needs may call for several at once.
  3. 3
    Revision has to coexist with consistency, since an evaluation that changes constantly cannot reliably guide application development.
  4. 4
    Experiment tracking logs every variable that could change, including the evaluation data, the rubric, and the prompt and sampling configurations for the AI judges, so that results can be compared and reproduced.

At a glance

  • An evaluation pipeline must be revised as user needs and behaviors change, because criteria that once matched real goals can go stale.
  • The three levers of revision are the evaluation criteria, the scoring rubric, and the examples, and they can be changed independently or together.
  • Consistency still matters: an evaluation that changes constantly cannot tell you whether a score change came from the application or from the evaluation itself.
  • Experiment tracking records every variable that could change, including evaluation data, the rubric, and the judge prompt and sampling configurations, so each result can be explained and reproduced.

Related concepts

More concepts starting with E