What you will be able to do
- Turn a vague goal such as 'classify sentiment well' into a specific, measurable, achievable and relevant success criterion
- Tell task-specific, generic, operational and qualitative metrics apart, and explain why most applications need several of them
- Measure accuracy and task success against a golden answer or the final outcome, and set a pass threshold for it
Key concept
Multidimensional success criteria — A model is never judged on one number. You decide in advance which dimensions matter for your application, such as accuracy, consistency, latency, cost and safety, and give each one a measurable target that an evaluation can confirm or reject.
1.Start with success criteria, not with a model
Before you compare prompts or models, you need a definition of 'good'. Anthropic's testing guidance puts this first: you build an LLM application by defining success criteria, then designing evaluations that measure performance against them. Without criteria, an evaluation only produces numbers that nobody can interpret.
The guidance names four qualities a criterion needs. It must be specific: 'good performance' is not a target, but 'accurate sentiment classification' is. It must be measurable, using a quantitative metric or a well-defined qualitative scale. It must be achievable, which means the target comes from industry benchmarks, earlier experiments, AI research or expert knowledge, not from wishful thinking. And it must be relevant to what the application is for and what its users need. The guide's example: strong citation accuracy might be critical for a medical app but matter much less for a casual chatbot.
| Quality | What it requires | Example from the guidance |
|---|---|---|
| Specific | State exactly what you want to achieve | 'accurate sentiment classification' instead of 'good performance' |
| Measurable | A quantitative metric, or a qualitative scale applied consistently | An F1 score of at least 0.85 |
| Achievable | Targets based on benchmarks, prior experiments, research or expert knowledge | A 5% improvement over the current baseline |
| Relevant | Tied to the application's purpose and its users' needs | A held-out test set of 10,000 diverse Twitter posts for a Twitter sentiment model |
Compare the two versions of the same goal. 'The model should classify sentiments well' gives an evaluator nothing to check. The improved version reads: the model should achieve an F1 score of at least 0.85 on a held-out test set of 10,000 diverse Twitter posts, a 5% improvement over the current baseline. One sentence now names the metric, the threshold, the data and the reason the target is realistic.
Checkpoint 1 of 5· Match them up
Match each part of the improved sentiment criterion to the quality it provides
Tap a term, then the definition that fits it.
The guide labels each clause of its good example this way. Basing the target on the current baseline is what makes it achievable, because targets should come from prior results or benchmarks.
“Achievable: Base your targets on industry benchmarks, prior experiments, AI research, or expert knowledge.”Source: platform.claude.com
Sources1
2.Kinds of metrics and why you need several
After you decide a criterion must be measurable, you choose how to measure it. The guidance sorts quantitative metrics into three families and adds qualitative scales for things numbers don't capture well.
| Family | Examples |
|---|---|
| Task-specific (quantitative) | F1 score, BLEU score, perplexity |
| Generic (quantitative) | Accuracy, precision, recall |
| Operational (quantitative) | Response time (ms), uptime (%) |
| Qualitative scales | Likert scales (for example, coherence rated 1 to 5), expert rubrics |
Numbers are preferred because they're clear and scale well. Qualitative measures still have a place, as long as they are applied consistently and alongside quantitative ones. The guidance also lists methods that produce numbers: A/B testing against a baseline or earlier version, implicit user feedback such as task completion rates, and edge case analysis (the percentage of edge cases handled without errors).
No single family covers a real application. The guide lists dimensions you may need to consider: task fidelity, including rare or hard inputs; consistency (whether the same question asked twice gets a semantically similar answer); relevance and coherence; tone and style; privacy preservation; how well the model uses the context it's given; latency; and price. This is why its fully worked criterion bundles several targets on one held-out set of 10,000 Twitter posts: an F1 score of at least 0.85, 99.5% of outputs non-toxic, 90% of errors causing inconvenience rather than egregious harm, and 95% of responses in under 200ms.
Checkpoint 2 of 5· Check yourself
A team tracks F1 score, accuracy and 'response time (ms)'. Which of these is an operational metric rather than a task-specific or generic one?
The guidance groups response time and uptime as operational metrics. F1 is task-specific, and accuracy and precision are generic.
“Quantitative metrics: Task-specific: F1 score, BLEU score, perplexity Generic: Accuracy, precision, recall Operational: Response time (ms), uptime (%)”Source: platform.claude.com
Checkpoint 3 of 5· Exam question
A fintech company built an automated support-ticket triage system that assigns each incoming ticket to exactly one of five fixed categories (billing, fraud, account access, technical issue, other). The team wants to measure how well the model performs this core categorization task using a labeled test set of 5,000 tickets, with automated, unambiguous grading. Which evaluation approach should the team use?
Correct answer: A — Score each output against the labeled category using exact-match accuracy or an F1 score computed from the confusion matrix
- A. Correct. For a task with fixed, categorical labels and a large labeled test set, exact-match accuracy or F1 gives simple, unambiguous, scalable automated grading with no false positives or negatives.
- B. Cosine similarity measures whether semantically similar inputs produce similar outputs; it does not check whether a categorization matches a ground-truth label.
- C. ROUGE-L measures overlap between generated and reference free text (e.g., summaries), not correctness of a discrete category assignment.
- D. Likert-scale grading is suited to subjective qualities like tone; a categorical task with ground-truth labels doesn't need subjective scoring and loses the precision of exact-match grading.
Sources1
3.Accuracy and task success
Accuracy is the dimension most applications define first. For tasks with clear, categorical answers, the simplest metric is exact match: does the output equal a predefined correct answer after you normalize whitespace and case? The guide's sentiment example labels each tweet by hand, classifies it with Claude, and reports the share that match.
Checkpoint 4 of 5· Fill the gap
This exact-match evaluation reports accuracy as the share of correct outputs. Which function completes the accuracy calculation?
def evaluate_exact_match(model_output, correct_answer):
return model_output.strip().lower() == correct_answer.lower()
outputs = [
get_completion(
f"Classify this as 'positive', 'negative', 'neutral', or 'mixed': {tweet['text']}"
)
for tweet in tweets
]
accuracy = ? (
evaluate_exact_match(output, tweet["sentiment"])
for output, tweet in zip(outputs, tweets)
) / len(tweets)
print(f"Sentiment Analysis Accuracy: {accuracy * 100}%")Each exact-match check returns True or False. Summing them counts the correct outputs, and dividing by len(tweets) turns that count into an accuracy rate.
Source: platform.claude.comAn accuracy figure only becomes a criterion when it has a threshold. In the ticket-routing guide, the evaluation script returns accuracy, response time and cost per classification, and the guide then sets targets, such as 95% accuracy over 100 tests. The customer-support guide sets a target for each kind of accuracy: 100% for introductory company and product information, 100% for generated quotes, and an escalation accuracy of 95% or higher.
For agents that work over many turns, task success needs a sharper definition. Anthropic's agent-evaluation post separates the transcript, which is the full record of a trial including outputs and tool calls, from the outcome, which is the final state of the environment when the trial ends. An agent can report success in the transcript and still leave the environment unchanged. Define task success on the outcome. Because model outputs vary between runs, run several trials of each task to get a stable success rate.
Checkpoint 5 of 5· Check yourself
Your routing evaluation script prints accuracy, response time and cost per classification for 100 test tickets. What does the guidance say you still need before you can call the evaluation complete?
Raw metric values don't say whether a result is good. Thresholds such as 95% accuracy turn them into pass/fail criteria.
“The preceding script returns the runtime values for accuracy, response time, and cost per classification, but you still need clearly established thresholds.”Source: platform.claude.com
Exam traps
Each one states something that sounds right. Open it to see what is actually true.
1.Success targets should be as ambitious as possible to push the model.Why is that wrong?
Targets must be achievable. Base them on benchmarks, prior experiments, research or expert knowledge, and keep them within what current frontier models can do.
2.If the agent's final message says the task is done, the trial counts as a success.Why is that wrong?
For agents, success is measured on the outcome, which is the final state of the environment, not on what the transcript claims.
Covered in Accuracy and task success
Sources
Every claim above is drawn from one of these pages, quoted as it was written on the date shown.
- 1.
“Building a successful LLM-based application starts with clearly defining your success criteria and then designing evaluations to measure performance against them.”
↩︎ Start with success criteria, not with a model“Strong citation accuracy might be critical for medical apps but less so for casual chatbots.”
↩︎ Start with success criteria, not with a model“Numbers provide clarity and scalability, but qualitative measures can be valuable if consistently applied along with quantitative measures.”
↩︎ Kinds of metrics and why you need several“Edge case analysis: Percentage of edge cases handled without errors.”
↩︎ Kinds of metrics and why you need several“Exact match evals measure whether the model's output matches a predefined correct answer, typically after normalizing whitespace and case.”
↩︎ Accuracy and task success“Most use cases need multidimensional evaluation along several success criteria.”
↩︎ Key concept“Your success metrics should not be unrealistic to current frontier model capabilities.”
↩︎ Exam trap 1“Achievable: Base your targets on industry benchmarks, prior experiments, AI research, or expert knowledge.”
↩︎ Checkpoint“Quantitative metrics: Task-specific: F1 score, BLEU score, perplexity Generic: Accuracy, precision, recall Operational: Response time (ms), uptime (%)”
↩︎ Checkpoint - 2.
“Accuracy: 95% (out of 100 tests)”
↩︎ Accuracy and task success“The preceding script returns the runtime values for accuracy, response time, and cost per classification, but you still need clearly established thresholds.”
↩︎ Checkpoint - 3.
“Aim for an escalation accuracy of 95% or higher.”
↩︎ Accuracy and task success - 4.
“Because model outputs vary between runs, we run multiple trials to produce more consistent results.”
↩︎ Accuracy and task success“The outcome is the final state in the environment at the end of the trial.”
↩︎ Exam trap 2“the outcome is whether a reservation exists in the environment’s SQL database.”
↩︎ Prediction