Back to news

Code

Agent Evaluation: How to Measure Agent Performance.

Agent Evaluation: How to Measure Agent Performance: The four-level measurement pyramid that separates reliable agent deployments from hopeful experiments,…

AI Kick Start editorial image for Agent Evaluation: How to Measure Agent Performance.
Decision

Start narrow

Use the article to decide the smallest useful workflow worth testing before expanding the system.

Risk to watch

Hype drift

Avoid turning a practical adoption step into a broad transformation promise nobody can verify.

Proof to collect

Business signal

Write down the owner, data boundary, review point, and measurable outcome before the first build.

TL;DR

TL;DR: A four-level measurement pyramid separates reliable agent deployments from hopeful experiments. It runs from component metrics up to business impact, with a way to evaluate each level.

Key takeaways

  • Briefing: Briefing Most teams running AI agents have no idea whether the thing is actually working.
  • The Measurement Pyramid: The Measurement Pyramid Agent evaluation works at four levels: Level 4: Business Impact (revenue, velocity, satisfaction) Level 3: Task Outcomes (success rate, quality, time) Level 2: Technical Metrics (token usage, latency, error rate) Level 1: Component Metrics (tool accuracy, context relevance, prompt adherence) Most teams measure Level 2 and stop there.
  • Level 1: Component Metrics: Level 1: Component Metrics Component metrics tell you which specific thing is breaking: Tool accuracy % of tool calls with correct parameters >95% Context relevance % of retrieved context actually used >80% Prompt adherence % of constraints followed in output >90% Hallucination rate % of outputs containing fabricated information <2% Format compliance % of outputs matching requested format >95% These need automated evaluation, usually model-based.
  • Level 2: Technical Metrics: Level 2: Technical Metrics Technical metrics watch system health: Token usage per task Average tokens consumed Minimise Latency (p50/p95) Time to task completion p50<60s, p95<300s Error rate %
  • Level 3: Task Outcomes: Level 3: Task Outcomes Task outcome metrics ask the question that matters: did the agent actually get the job done?
  • Level 4: Business Impact: Level 4: Business Impact Business impact metrics tie agent usage back to what the organisation actually cares about: Developer velocity Story points or PRs per sprint Bug escape rate Bugs found in production vs.
Table of contents

Briefing

Most teams running AI agents have no idea whether the thing is actually working. It writes code, it answers tickets, it drafts emails, and the dashboard looks busy. But ask a simple question, "is this agent better or worse than it was last month?", and the room goes quiet.

That gap is the whole problem. An agent that feels productive can be quietly burning money, shipping bugs, and creating cleanup work that nobody is counting. The only way to know the difference is to measure it properly, and most organisations measure the easy stuff (tokens, speed) while ignoring the parts that decide whether the agent earns its keep.

This is a practical guide to closing that gap. It lays out a four-level way to score agent performance, from the nuts-and-bolts technical numbers up to the business outcomes your finance team cares about. None of it requires a data science team. It does require deciding, on purpose, what good looks like before you deploy.

You cannot improve what you do not measure. Agent evaluation is the discipline of measuring agent performance with rigour rather than intuition. Here is the framework that separates reliable agent deployments from hopeful experiments.

The Measurement Pyramid

Agent evaluation works at four levels:

Level 4: Business Impact (revenue, velocity, satisfaction)
Level 3: Task Outcomes (success rate, quality, time)
Level 2: Technical Metrics (token usage, latency, error rate)
Level 1: Component Metrics (tool accuracy, context relevance, prompt adherence)

Most teams measure Level 2 and stop there. The teams getting real value measure all four, and they understand how each level feeds the next.

Level 1: Component Metrics

Component metrics tell you which specific thing is breaking:

MetricDefinitionTarget
Tool accuracy% of tool calls with correct parameters>95%
Context relevance% of retrieved context actually used>80%
Prompt adherence% of constraints followed in output>90%
Hallucination rate% of outputs containing fabricated information<2%
Format compliance% of outputs matching requested format>95%

These need automated evaluation, usually model-based. Claude Code's built-in telemetry covers some of them: with OpenTelemetry turned on, it emits token usage, cost, session counts, and tool-execution events you can mine for component data (Anthropic Claude Code docs, Monitoring usage (opens in a new tab)). For retrospective digging, Hermes' FTS5 session database lets you full-text search across past sessions and pull patterns out of old transcripts (Nous Research Hermes Agent, Session Storage (opens in a new tab)).

Level 2: Technical Metrics

Technical metrics watch system health:

MetricDefinitionTarget
Token usage per taskAverage tokens consumedMinimise
Latency (p50/p95)Time to task completionp50<60s, p95<300s
Error rate% of tasks ending in error<5%
Retry rate% of tasks requiring human intervention<20%
Cost per taskToken cost + computeTrack and optimise

Level 3: Task Outcomes

Task outcome metrics ask the question that matters: did the agent actually get the job done?

MetricDefinitionMeasurement
Success rate% of tasks completed without human fixHuman review
First-attempt success% correct on first tryAutomated + spot check
Code quality scoreComposite of lint, test, reviewAutomated pipeline
Regression rate% of changes that break existing codeCI/CD
Time saved(Human estimate) - (Agent time)Self-report

Level 4: Business Impact

Business impact metrics tie agent usage back to what the organisation actually cares about:

MetricDefinition
Developer velocityStory points or PRs per sprint
Bug escape rateBugs found in production vs. development
Developer satisfactionSurvey scores
Time to resolutionMean time to fix bugs or implement features
Knowledge transfer speedTime for new developers to become productive

Evaluation Methodologies

Human Evaluation

The gold standard, and expensive. Use it for:

  • Calibrating your automated evaluators at the start
  • Edge cases and task types you haven't seen before
  • Final sign-off on production deployments

Model-Based Evaluation

Use a stronger model to grade a weaker model's output. For example, an Opus-class model can score the work of a faster Sonnet-class model. (One commonly cited version of this, that Claude Code internally uses Opus 4.8 to grade Sonnet 4.8 outputs, is unconfirmed: it has no public source, and "Sonnet 4.8" does not appear to be a released model. The current Sonnet is Sonnet 4.6 (opens in a new tab); Opus 4.8 (opens in a new tab) is real.) The approach scales well, but it inherits whatever biases the evaluator model carries.

def model_evaluate(output, criteria, evaluator="opus-4.8"):
 prompt = f"Evaluate this output on {criteria}. Score 1-10. Explain."
 return claude.generate(prompt, model=evaluator)

Reference-Based Evaluation

Compare agent output against human-written reference solutions, using BLEU, ROUGE (opens in a new tab), or custom similarity metrics. It's only as good as the reference solutions you have, in quality and in coverage.

Execution-Based Evaluation

Run the generated code and see if it passes the tests. For coding tasks this is the most objective metric you'll get. The catch is that it leans entirely on the quality of your test suite.

Building an Evaluation Suite

evaluation_suite/
├── unit_tests/ # Does generated code compile and pass?
├── integration_tests/ # Does it work with the rest of the system?
├── regression_tests/ # Does it break anything?
├── quality_checks/ # Lint, format, complexity
├── reference_compare/ # Similarity to human-written solutions
└── human_review/ # Manual quality assessment

Run the full suite before you deploy any prompt or model change. Run component metrics continuously. Review business impact monthly.

Red Flags

These patterns tell you the evaluation itself is broken:

  • Measuring proxy metrics: "Lines of code generated" barely correlates with value
  • Cherry-picking examples: Testing only on tasks you already know the agent handles well
  • No human baseline: If you don't know how a person performs, the agent's numbers mean nothing
  • Static benchmarks: Agent performance drifts, so evaluate continuously
  • Ignoring failure modes: Counting wins without categorising the losses

Agent evaluation isn't a one-off. It's an ongoing practice, and it decides whether your deployment gets better or worse over time. Teams that evaluate well ship with confidence. Teams that don't are just hoping.

Agent Evaluation: answer-first summary

Agent Evaluation matters because it can change how Australian business teams plan, build, or govern an agent workflow. The four-level measurement pyramid that separates reliable agent deployments from hopeful experiments, from component metrics to business impact.

The direct answer is this: do not treat the topic as a standalone trend. Treat it as a decision about inputs, outputs, review ownership, data exposure, and whether the workflow produces a result that is faster, safer, or more useful than the current process.

Agent Evaluation: implementation checklist

  • Define the user, job to be done, and success metric for the agent workflow.
  • Collect real examples, policies, source files, customer questions, or search queries before writing prompts or choosing tools.
  • Separate low-risk drafts from decisions that need approval, privacy checks, or senior review.
  • Document what the AI is allowed to access, what it must not access, and who signs off before production use.
  • Review successful task completion, review time, fallback rate, operator corrections after a small pilot rather than judging the idea from a demo.

This keeps the work practical. It also gives search engines and AI answer engines a clean factual structure: what the topic is, who it helps, what to do next, and which risks matter before implementation.

Decision criteria for Agent Evaluation

Decision areaWhat to checkProduction signal
IntentDoes Agent Evaluation solve a real workflow problem?The use case has a named owner and measurable outcome.
DataCan the required data be used safely?Sensitive data is classified and access is controlled.
QualityCan a reviewer judge the output consistently?Examples, rubrics, or acceptance criteria exist.
ScaleCan the workflow be repeated without hero effort?The process is documented and can be handed to another team member.

Practical example for Agent Evaluation

A small business could use this article to choose one practical test. For example, a manager might take one customer-facing process, one internal document workflow, or one recurring content task and redesign only that step with AI support. The goal is not to automate the whole business at once; it is to learn where Code creates reliable leverage.

The useful deliverable is a short operating note: the trigger, the source material, the prompt or tool, the review checklist, the escalation rule, and the metric. That note becomes the handover asset for staff training, SEO/GEO content, service delivery, or future agent work.

Risks and controls for Agent Evaluation

The common failure pattern is moving too quickly from a promising idea into an unmanaged workflow. For Agent Evaluation, the risk is not only bad output. It can also be unclear data permission, staff confusion, duplicate content, unreviewed customer advice, or a tool that quietly changes cost or capability.

  • Control unclear tool permissions with a named owner, a review step, and written acceptance criteria.
  • Control silent failures with a named owner, a review step, and written acceptance criteria.
  • Control prompt drift with a named owner, a review step, and written acceptance criteria.
  • Control weak audit trails with a named owner, a review step, and written acceptance criteria.

Measurement plan for Agent Evaluation

A useful AI or SEO initiative should leave evidence. Track successful task completion, review time, fallback rate, operator corrections and compare the pilot against the current process. If the measure does not improve, keep the learning but avoid scaling the workflow.

For GEO readiness, the page should also answer the core question directly, define the entities involved, include implementation steps, explain tradeoffs, and link readers to the next relevant AI Kick Start service, guide, tool, or article.

Definitions and entities for Agent Evaluation

For search, GEO, and staff handover, define the core entities in plain language. In this article the important entities are the workflow owner, the AI tool or model, the source material, the review process, the risk boundary, and the measurable business outcome. Clear definitions make the page easier for people to scan and easier for AI answer engines to quote accurately.

  • Workflow owner: the person accountable for deciding whether Agent Evaluation belongs in the business process.
  • Source material: the documents, examples, policies, URLs, prompts, videos, or customer questions that ground the output.
  • Review boundary: the point where a human checks accuracy, privacy, brand voice, or customer impact before the result is used.
  • Success metric: the measure that proves whether the agent workflow is worth repeating.

Agent Evaluation versus doing nothing

Doing nothing is also a decision. The cost may be slow manual work, weaker search visibility, inconsistent advice, duplicated effort, or staff using unmanaged AI tools without a shared process. The practical question is whether a controlled pilot can reduce that cost without creating a larger governance problem.

OptionWhen it makes senseWhat to watch
Do nothingThe workflow is rare, low value, or already reliable.Competitors may improve speed, content depth, or service consistency first.
Run a small pilotThe task repeats often and has clear review criteria.Keep scope tight and measure the result against the current process.
Build a production workflowThe pilot is repeatable and risk controls are documented.Assign ownership, monitoring, training, and a rollback path.

AI Kick Start handover package for Agent Evaluation

A production handover should be concrete enough that another person can run it. For Agent Evaluation, that means a short brief, a workflow map, approved prompts or tool settings, source material, a review checklist, internal links to supporting resources, and a simple measurement sheet. This is the difference between reading about AI and turning it into operational capability.

That packaging also strengthens E-E-A-T. It shows experience through implementation notes, expertise through decision criteria, authoritativeness through source-aware structure, and trust through risks, controls, and review steps. The article becomes useful even if the reader never buys a tool because it helps them make a better operational decision.

Source trail

Primary references to keep this briefing grounded

AI and automation information changes quickly. Use these official or primary references to verify the claims, pricing, product behaviour, and compliance details before committing budget or production data.

Frequently asked questions

What is the practical takeaway from Agent Evaluation?

The four-level measurement pyramid that separates reliable agent deployments from hopeful experiments, from component metrics to business impact. For AI Kick Start readers, the key is to translate the idea into one agent workflow with clear inputs, review points, and measurable outcomes. The article should be treated as implementation guidance, not a substitute for workflow design.

Who should use Agent Evaluation guidance in Code?

This guidance is most useful for Australian business teams who need to decide whether the topic changes tool selection, automation design, search visibility, data handling, training, or operational governance.

How should an Australian business implement Agent Evaluation?

Start small: define the agent boundary, give it test data, log its actions, and keep approval gates around customer or financial decisions. If the pilot improves successful task completion and review time, document the pattern, link it to the relevant service or resource page, and then decide whether it belongs in a production workflow.

What to do next

  1. For Agent Evaluation, write down the single agent workflow this article should improve.
  2. Collect real examples, edge cases, and source material before testing Agent Evaluation with any AI output.
  3. Before implementing Agent Evaluation, add a human review checkpoint for quality, privacy, brand, or customer-impact risk.
  4. Measure successful task completion, review time, fallback rate for Agent Evaluation before deciding whether to scale.
  5. Connect Agent Evaluation to a related service, resource, or training path so readers have a clear next action.

Want help applying this? Explore AI agent design systems.

AI Kick Start is an Illawarra-based AI studio in Figtree, helping businesses across Wollongong, Shellharbour and Kiama and right across Australia put AI to work.

Explore with AI

Use the article as a decision prompt

Summarise this AI Kick Start article for an Australian business owner. Focus on the useful decision, the risks, and the first practical next step: Agent Evaluation: How to Measure Agent Performance

Turn this into a practical roadmap.

Use the guide as a starting point, then map the first workflow worth building.

Book an AI strategy call