Use these notes to review a concept or read at your own pace. The interactive workspace above adds predictions, editable code, and actual run results.
IDEA 1
Choose a revealing failure case
An evaluation case pairs an input with a way to judge the result. A useful set contains ordinary requests and examples that expose likely mistakes: an exact capacity boundary, missing evidence, a conflicting record, or no valid choice. If every example is easy, a broken rule can look reliable. AgentBench studies agents across eight interactive environments, illustrating why one kind of task cannot stand in for all agent behavior.
Start from the task's definition of success. Here a room must be available and hold at least the requested group size. Capacity equal to the group size is allowed. A no-match answer is correct when no room satisfies both requirements. Writing these expectations before editing the agent makes it harder to quietly change the target to fit its output.
Turn a requirement into cases
- Requirement. Capacity must be at least the group size.
- Boundary. Try exactly 20 people in 20 seats.
- Failure. Try a large room that is unavailable.
Follow this authored example, then test the idea in the lab.
Read the example
const valid = room.available && room.capacity >= people;This check states a measurable requirement. Words such as 'excellent room' do not replace it.
Think it through: Which case is most likely to expose an accidental > instead of >= comparison?
IDEA 2
Test output and tool behavior
A grader is the procedure that assigns a result to a trial. Code graders can check exact fields and rules. Human reviewers can assess clarity or usefulness under a rubric. Model graders can help with judgments, but their outputs are fallible and need validation. None should be described as an automatic detector of truth in every domain.
Our grader reads the room fixture and an authored candidate. It checks existence, availability, and capacity separately, or verifies that a proposed null really means no valid room exists. The candidate's confidence field is deliberately ignored. The surrounding lab also checks tool calls: reading the evidence is part of the required behavior, while a correct-looking hard-coded answer is insufficient.
Grade the result against evidence
- Observe. Read the actual room records.
- Check. Evaluate each stated requirement.
- Report. Keep the failed criterion visible.
Follow this authored example, then test the idea in the lab.
Read the example
const failed = Object.keys(checks).filter(key => !checks[key]);
return { passed: failed.length === 0, failed };A specific failed criterion helps you fix the system. The grader does not award points for confident wording.
Think it through: A candidate says confidence: 0.99, but the room is unavailable. What should this grader do?
IDEA 3
Repeat live-model trials without tuning to the test set
A task is the request being evaluated; a trial is one attempt at that task. A live model may make different choices across repeated trials. Report the number of trials and the observed variation under a recorded model, configuration, dataset, and grader version. A single successful run does not establish reliable behavior.
Keep some cases held out: do not use them to choose prompts or edit rules during development. Fitting the visible examples can hide failures on nearby inputs. This deterministic browser lab runs no live model, so repeating unchanged input cannot measure model variability. Its three cases teach evaluation mechanics.
Read benchmark labels carefully. SWE-bench evaluates software changes for repository issues; its named variants use different task sets. A result there answers a different question from a room-selection check here. Record which tasks, agent setup, and grader produced a score before comparing it with another result. No benchmark is a certificate that an agent is ready for every use.
Separate improvement from assessment
- Develop. Use visible cases to diagnose mistakes.
- Freeze. Record the code and grader before the final check.
- Assess. Use held-out inputs; repeat actual model trials when relevant.
Follow this authored example, then test the idea in the lab.
Read the example
const report = { dataset: "rooms-practice-v1", grader: "availability-capacity-v1" };Version labels identify what was tested. They do not make a tiny practice set representative by themselves.
Think it through: What does passing these three fixed JavaScript cases establish?
Put it into practice
Judge a proposed room using explicit fixture facts; report failed criteria and accept a justified no-match.
- Read the selected case and predict its expected result.
- Run the starter once. Use the failed check and tool trace to locate the missing rule.
- Insert the explained snippet at the TODO, then run the case again.
- Test all three cases. Change the experiment input and explain whether the same rule still works.
Your next experiment: Propose null even though room A is available and large enough. Which criterion should fail? Then try an invented room ID.
State the success rule, test revealing failures, and describe only what the observed trials support.
Key terms
- Grader
- The code, rubric, or review process that judges a trial.
- Held-out case
- A case reserved for assessment rather than development decisions.
- Trial
- One attempt at an evaluation task under a recorded configuration.
Sources and scope
Original Stemtiq teaching, reviewed 2026-09-14. The named researchers and organizations do not endorse this course. Classroom cases are authored exercises, not published findings.
Anthropic: Demystifying evals for AI agents
9 January 2026
Define tasks, trials, and graders; inspect both execution records and final outcomes; repeat trials when model behavior varies.
A score depends on its cases and grading rules. Repeating a deterministic classroom case does not measure the variability of a live model.
OpenAI: Evaluate agent workflows
Reviewed 13 September 2026 · undated documentation
Use traces to locate workflow failures, then apply structured graders and repeatable datasets to compare behavior across changes.
Traces record observable execution, not private model reasoning. Passing selected criteria does not demonstrate correctness on every task or connect this lab to an evaluation service.
Jimenez et al. · SWE-bench research team: SWE-bench: Can Language Models Resolve Real-World GitHub Issues?
ICLR 2024 · original benchmark
Evaluate patches against repository issues and executable tests using a reproducible harness. Inspect the actual code change and its tested behavior.
Benchmark variants cover different tasks. Passing a repair case does not establish general coding ability or that a patch meets every unstated requirement.
Liu et al. · AgentBench research team: AgentBench: Evaluating LLMs as Agents
7 August 2023 · v3 revised 4 October 2025 · reviewed 14 September 2026
Evaluate agent behavior in distinct interactive environments and keep the task, environment, and evaluation procedure visible when interpreting a result.
Its eight environments do not represent every deployment. Historical model results are not current rankings, and a classroom pass rate cannot be compared with AgentBench results.