83 / 90

Day 83: Scientific Agent Evaluation II — Confounders, Failure Attribution & Honest Interpretation

Interpret measured evidence correctly: isolate confounders, attribute failures to observable causes, and report uncertainty instead of rankings.

Agent Engineering & Scientific Evaluation 480 active minutes (8 hours)
01 120 min

Confounder Analysis: Model, Harness, Configuration, and Sample Limits

Agent-Assisted Engineering Check

Prerequisites

Day 82 registered protocol document.

Learning Objective

Enumerate and control the confounders — model identity and pinned revision, decoding configuration, harness and tool surface, prompt context, and sample size — so observed differences are not misattributed to a single cause.

Instructions

Study source: within this activity's existing reading/practice time, use Demystifying evals for AI agents, Types of graders for agents; capability vs. regression evals; repeated-trial reliability, then explain one connection to the local task in your own words. Keep the local exercise and acceptance checks; use its original explanation if the external source is unavailable. 1. Build a confounder register with columns: variable, observed value, controlled-or-free, and likely effect direction. Include model id + revision, temperature/seed, context length, tool schema versions, retry policy, and wall-clock variance.
2. Quantify sample limits: on a six-task suite one flipped outcome changes the success rate by ~17 percentage points; compute a Wilson interval for 6/6 to see how wide the honest range is.
3. Write the reporting rule: with small n, report raw counts and intervals, never absolute tool rankings.
4. Separate harness effects from model effects in a two-axis comparison table; mark cells you cannot isolate as 'confounded' rather than guessing.

Practice & Prediction Log

Produce confounder_register.md listing at least six variables with controlled/free status, plus the sample-size calculation showing why 6 tasks cannot support a ranking claim.

Independent Mastery Criterion

Explain which variables a comparison controls and which it leaves free, and refuse ranking claims the sample cannot support.

Authoritative Source Resources & Provenance

linking Anthropic copyright; no open reuse license verified linking only; no reproduction

Demystifying evals for AI agents

Author: Anthropic Engineering | Original Source Link ↗

Relevant Section / Range: Types of graders for agents; capability vs. regression evals; repeated-trial reliability

Verified Version & Date: Public edition checked 2026-11-01; moving pages may change

Selection Rationale:

Teaching-oriented task/trial/grader/outcome distinctions and a staged eval-building workflow complement the original benchmark definitions. No vendor product is required for the local exercises.

Source Prerequisites:

Bounded agent loops, task outcomes, traces and deterministic acceptance tests.

Safe Fallback (Offline Resilience):

Use the original localized explanations, exercises and checks already present in this activity; no external account or purchase is required for that fallback.

Compared Candidate Sources & Selection Analysis (2)
SWE-bench ↗ compared_alternative [Open Access / CC BY 4.0]

Retained for issue-to-patch fail-to-pass definitions; not a general teaching workflow.

tau-bench ↗ compared_alternative [Open Access / CC BY 4.0]

Retained for the exact pass^k definition; practitioner guidance cannot replace the paper's metric semantics.

linking Open Access / CC BY 4.0

tau-bench: A Benchmark for Tool-Agent-User Interaction in Real-World Domains

Author: Shunyu Yao, Noah Shinn, Pedram Razavi, Karthik Narasimhan | Original Source Link ↗

Relevant Section / Range: Section 3 τ-bench: A benchmark for Tool-Agent-User Interaction (pass^k definition); Section 4.2 Key Characteristics; Section 5 Experiments (pass^k results)

Verified Version & Date: ICLR 2025 / arXiv:2406.12045v2 (Verified: 2026-10-30)

Selection Rationale:

Introduces pass^k consistency metrics and database-state outcome checks for tool-agent-user interaction, separating reliable task completion from single lucky runs.

Source Prerequisites:

Tool-calling APIs, conversational agents, and policy-following evaluation.

Safe Fallback (Offline Resilience):

Consistency metrics and state-based outcome checking are re-implemented on the curriculum deterministic fixture for offline practice.

Compared Candidate Sources & Selection Analysis (2)

Stateful tool-use evaluation with milestone events; tau-bench additionally models a simulated user and reports pass^k reliability.

Berkeley Function-Calling Leaderboard (BFCL) ↗ compared_alternative [Apache 2.0 (Gorilla project)]

Live leaderboard for function-call correctness across languages and parallel calls; tau-bench adds policy adherence and multi-trial consistency.

linking Open Access / CC BY 4.0

AgentBench: Evaluating LLMs as Agents

Author: Xiao Liu, Hao Yu, Hanchen Zhang, Yifan Xu, Xuanyu Lei, Hanyu Lai, Yu Gu, Hangliang Ding, Kaiwen Men, Kejuan Yang, et al. | Original Source Link ↗

Relevant Section / Range: Section 4.1 Evaluation Setup and Section 4.3 Analysis

Verified Version & Date: ICLR 2024 / arXiv:2308.03688v2 (Verified: 2026-10-30)

Selection Rationale:

First systematic multi-environment benchmark measuring LLM-as-agent ability across eight interactive settings, establishing fixed task suites, environment-specific scoring, and comparable evaluation conventions.

Source Prerequisites:

LLM prompting, tool-use environments, and multi-step task decomposition.

Safe Fallback (Offline Resilience):

The curriculum fixes its own six-task evaluation suite with deterministic-v1 fixture analogs, so all protocol-design practice runs offline without reproducing AgentBench environments.

Compared Candidate Sources & Selection Analysis (2)

Real computer-control benchmark for open-ended desktop tasks; AgentBench covers a wider environment spectrum for foundational evaluation design.

Mind2Web: Towards a Generalist Agent for the Web ↗ compared_alternative [Open Access]

Generalist web-agent benchmark with 2,350 tasks; AgentBench provides broader multi-domain coverage for studying evaluation protocol design.

02 120 min

Failure Attribution Taxonomy from Action/Observation Traces

Independent Mastery Check (no AI assistance).

Prerequisites

Day 83 Activity 1 confounder register.

Learning Objective

Attribute every failure to an observable cause class using recorded action/observation traces — never inferred hidden reasoning — and map each live task to its deterministic analog's expected contract.

Instructions

1. Define the taxonomy classes: tool-schema violation, unregistered tool call, missing resource, permission denial, retry/step-budget exhaustion, premature termination, and dishonest termination.
2. For each of the six live tasks, write the deterministic_analog expectation beside the observed trace fields (status, steps, retries, termination_reason).
3. Attribute each failure to exactly one primary class with a pointer to the trace evidence that proves it.
4. Mark ambiguous attributions 'unresolved' rather than forcing a label; unresolved entries become questions for the next protocol revision.
5. Emit failure_taxonomy.json with per-task class, evidence pointer, and ambiguity flag.

Practice & Prediction Log

Write failure_taxonomy.json attributing each contract task outcome to one taxonomy class, with trace evidence pointers and honest 'unresolved' flags where evidence is insufficient.

Independent Mastery Criterion

Classify failures by observable trace evidence and leave insufficient-evidence cases honestly unresolved.

Authoritative Source Resources & Provenance

linking Open Access / CC BY 4.0

SWE-bench: Can Language Models Resolve Real-World GitHub Issues?

Author: Carlos E. Jimenez, John Yang, Alexander Wettig, Shunyu Yao, Kexin Pei, Ofir Press, Karthik R. Narasimhan | Original Source Link ↗

Relevant Section / Range: N/A

Verified Version & Date: ICLR 2024 / arXiv:2310.06770v3 (Verified: 2026-10-30)

Selection Rationale:

Defines the standard pattern this block teaches: a bounded issue statement paired with executable fail-to-pass tests as verifiable acceptance criteria for agent-produced changes.

Source Prerequisites:

Unit testing, issue descriptions, and repository evaluation vocabulary.

Safe Fallback (Offline Resilience):

The acceptance-criteria pattern is exercised locally through the Ticket 22 fixture scorer and the Ticket 24 regression exercise without external datasets.

Compared Candidate Sources & Selection Analysis (2)
HumanEval: Evaluating Large Language Models Trained on Code ↗ compared_alternative [arXiv non-exclusive license / Open Access]

Function-level synthesis benchmark; SWE-bench models the repository-scoped issue-to-diff workflow that this delivery block rehearses.

Multi-SWE-bench: A Multilingual Benchmark for Issue Resolving ↗ compared_alternative [Open Access / CC BY 4.0]

Extends issue resolution to multiple programming languages; the original Python-centric SWE-bench provides a cleaner pedagogical anchor.

linking MIT

OpenAI Evals: Framework for Evaluating LLMs and Contamination Checks

Author: OpenAI Research | Original Source Link ↗

Relevant Section / Range: N/A

Verified Version & Date: OpenAI Evals Repository (Verified: 2026-10-30)

Selection Rationale:

Standardized evaluation repository specifying rigorous separation of eval prompts, canary GUID strings, and contamination test protocols.

Source Prerequisites:

Python, evaluation harnesses (MMLU, GSM8K), JSONL datasets.

Safe Fallback (Offline Resilience):

Canary GUID matching, token set intersection, and leak detection scripts are implemented in the curriculum.

Compared Candidate Sources & Selection Analysis (2)
EleutherAI LM Evaluation Harness ↗ compared_alternative [MIT]

Widely adopted evaluation harness; OpenAI Evals provides explicit canary guidance and contamination check specifications.

Hugging Face Lighteval ↗ compared_alternative [MIT]

Modern lightweight eval framework; OpenAI Evals illustrates standard test-set integrity guarantees.

03 120 min

Cost, Retry, and Latency Accounting with Tool-Behavior Audits

Agent-Assisted Engineering Check

Prerequisites

Day 83 Activity 2 failure taxonomy.

Learning Objective

Measure the per-task cost surface — steps, retries, wall-clock, tokens when available, dollars only when authorized — and audit tool-call correctness independently of task outcome.

Instructions

1. Build a cost ledger with columns task_id, status, steps, retries, elapsed_s, tokens_in, tokens_out, cost_usd, and termination_reason.
2. Fill deterministic values from the fixture run; record token and dollar fields as null because no authorized live call exists.
3. Assert every task respected its declared step and retry ceilings; flag any unbounded retry loop as a budget failure even when the task succeeded.
4. Audit tool behavior separately: verify every recorded action name is in allowed_tools and every arguments payload is a JSON object, and report this result independently of outcome_passed.
5. State why 'correct tools, failed task' and 'wrong tools, lucky pass' must both appear in an honest report.

Practice & Prediction Log

Produce cost_ledger.csv plus a tool-audit verdict line, distinguishing task outcome from tool correctness for every recorded task.

Independent Mastery Criterion

Account for cost and tool behavior as first-class metrics, separated from raw task success.

Authoritative Source Resources & Provenance

linking arXiv non-exclusive license / Open Access

WebArena: A Realistic Web Environment for Building Autonomous Agents

Author: Shuyan Zhou, Frank F. Xu, Hao Zhu, Xuhui Zhou, Robert Lo, Abishek Sridhar, Xianyi Cheng, Tianyue Ou, Yonatan Bisk, Daniel Fried, Uri Alon, Graham Neubig | Original Source Link ↗

Relevant Section / Range: Section 3.2 Evaluation Annotation (functional correctness checks)

Verified Version & Date: ICLR 2024 / arXiv:2307.13854v4 (Verified: 2026-10-30)

Selection Rationale:

Defines reproducible web tasks scored by functional outcome rather than reference-string matching, grounding observable action/observation evidence for agent evaluation.

Source Prerequisites:

Web navigation, browser action spaces, and functional correctness checking.

Safe Fallback (Offline Resilience):

The curriculum records action/observation traces on its own deterministic fixture, reproducing outcome-check discipline without hosting web environments.

Compared Candidate Sources & Selection Analysis (2)

Enterprise-workflow web benchmark; WebArena offers broader self-hosted site diversity for foundational protocol study.

Extends WebArena to visual grounding; WebArena remains the base reference for action-space and functional scoring design.

linking Open Access / CC BY 4.0

tau-bench: A Benchmark for Tool-Agent-User Interaction in Real-World Domains

Author: Shunyu Yao, Noah Shinn, Pedram Razavi, Karthik Narasimhan | Original Source Link ↗

Relevant Section / Range: Section 3 τ-bench: A benchmark for Tool-Agent-User Interaction (pass^k definition); Section 4.2 Key Characteristics; Section 5 Experiments (pass^k results)

Verified Version & Date: ICLR 2025 / arXiv:2406.12045v2 (Verified: 2026-10-30)

Selection Rationale:

Introduces pass^k consistency metrics and database-state outcome checks for tool-agent-user interaction, separating reliable task completion from single lucky runs.

Source Prerequisites:

Tool-calling APIs, conversational agents, and policy-following evaluation.

Safe Fallback (Offline Resilience):

Consistency metrics and state-based outcome checking are re-implemented on the curriculum deterministic fixture for offline practice.

Compared Candidate Sources & Selection Analysis (2)

Stateful tool-use evaluation with milestone events; tau-bench additionally models a simulated user and reports pass^k reliability.

Berkeley Function-Calling Leaderboard (BFCL) ↗ compared_alternative [Apache 2.0 (Gorilla project)]

Live leaderboard for function-call correctness across languages and parallel calls; tau-bench adds policy adherence and multi-trial consistency.

04 120 min

Assessment: Statistical Interpretation Memo with Uncertainty Disclosure

Independent Mastery Check (no AI assistance).

Prerequisites

Day 83 Activities 1-3.

Learning Objective

Deliver an interpretation memo that reports the deterministic baseline, the confounder register, taxonomy counts, and explicit uncertainty — with no absolute tool rankings and no harness-versus-model attribution without controlled ablation.

Instructions

1. Write memo.md with sections: measured evidence, confounders, failure taxonomy counts, cost accounting, and declared non-claims.
2. Report the deterministic baseline metrics exactly as recomputed on Day 82; describe live results as unavailable pending authorization.
3. State the uncertainty argument: n is small, intervals are wide, single flips move the rate materially — therefore counts, not rankings.
4. List declared non-claims: no 'tool X beats tool Y', no 'harness caused the failure' without a controlled ablation, no success claims from self-report.
5. Attach the artifact path for every number in the memo.

Practice & Prediction Log

Submit memo.md containing recomputed baseline metrics, the confounder register, taxonomy counts, an uncertainty paragraph, and at least three explicit non-claims.

Independent Mastery Criterion

Independently write an interpretation memo whose claims are bounded by the measured evidence.

Authoritative Source Resources & Provenance

linking Open Access / CC BY 4.0

AgentBench: Evaluating LLMs as Agents

Author: Xiao Liu, Hao Yu, Hanchen Zhang, Yifan Xu, Xuanyu Lei, Hanyu Lai, Yu Gu, Hangliang Ding, Kaiwen Men, Kejuan Yang, et al. | Original Source Link ↗

Relevant Section / Range: Section 4.1 Evaluation Setup and Section 4.3 Analysis

Verified Version & Date: ICLR 2024 / arXiv:2308.03688v2 (Verified: 2026-10-30)

Selection Rationale:

First systematic multi-environment benchmark measuring LLM-as-agent ability across eight interactive settings, establishing fixed task suites, environment-specific scoring, and comparable evaluation conventions.

Source Prerequisites:

LLM prompting, tool-use environments, and multi-step task decomposition.

Safe Fallback (Offline Resilience):

The curriculum fixes its own six-task evaluation suite with deterministic-v1 fixture analogs, so all protocol-design practice runs offline without reproducing AgentBench environments.

Compared Candidate Sources & Selection Analysis (2)

Real computer-control benchmark for open-ended desktop tasks; AgentBench covers a wider environment spectrum for foundational evaluation design.

Mind2Web: Towards a Generalist Agent for the Web ↗ compared_alternative [Open Access]

Generalist web-agent benchmark with 2,350 tasks; AgentBench provides broader multi-domain coverage for studying evaluation protocol design.

linking MIT

OpenAI Evals: Framework for Evaluating LLMs and Contamination Checks

Author: OpenAI Research | Original Source Link ↗

Relevant Section / Range: N/A

Verified Version & Date: OpenAI Evals Repository (Verified: 2026-10-30)

Selection Rationale:

Standardized evaluation repository specifying rigorous separation of eval prompts, canary GUID strings, and contamination test protocols.

Source Prerequisites:

Python, evaluation harnesses (MMLU, GSM8K), JSONL datasets.

Safe Fallback (Offline Resilience):

Canary GUID matching, token set intersection, and leak detection scripts are implemented in the curriculum.

Compared Candidate Sources & Selection Analysis (2)
EleutherAI LM Evaluation Harness ↗ compared_alternative [MIT]

Widely adopted evaluation harness; OpenAI Evals provides explicit canary guidance and contamination check specifications.

Hugging Face Lighteval ↗ compared_alternative [MIT]

Modern lightweight eval framework; OpenAI Evals illustrates standard test-set integrity guarantees.