Build latest book artifacts / build (push) Canceled after 0s
dependency resolution / resolve (3.11) (push) Canceled after 0s
dependency resolution / resolve (3.13) (push) Canceled after 0s
deploy-pages / build (push) Canceled after 0s
deploy-pages / deploy (push) Canceled after 0s
i18n consistency check / check (push) Canceled after 0s
provider adoption tests / test (chapter2/context-compression) (push) Canceled after 0s
provider adoption tests / test (chapter2/prompt-injection) (push) Canceled after 0s
provider adoption tests / test (chapter2/system-hint) (push) Canceled after 0s
provider adoption tests / test (chapter3/log-sanitization) (push) Canceled after 0s
web-search-agent tests / test (push) Canceled after 0s
web-search-agent tests / agentbook (push) Canceled after 0s
7.5 KiB
7.5 KiB
theme, title, info, author, transition, mdc, lineNumbers, monaco, aspectRatio, canvasWidth, layout, class
| theme | title | info | author | transition | mdc | lineNumbers | monaco | aspectRatio | canvasWidth | layout | class |
|---|---|---|---|---|---|---|---|---|---|---|---|
| seriph | Lesson 25 — Did the Agent Improve—or Did the Numbers Move? | English video course for AI Agents in Depth | Bojie Li | slide-left | true | false | false | 16/9 | 980 | cover | cover |
Improve · Chapter 6 · Agent Evaluation
Did the Agent Improve—or Did the Numbers Move?
Significance, observability, ablations, and production evaluation
Lesson 25 of 42 · 17 minutes · Statistical Significance; Agent Observability; Internal Evaluation Infrastructure; Simulation Fidelity
layout: center class: text-center
The central question
What evidence is required before an evaluation delta becomes an engineering decision?
Why this problem matters
Uncertainty
Repeated samples expose variance and paired differences.
Observability
Traces connect aggregate regressions to mechanisms.
Release control
Feature flags, A/B tests, rollback, and privacy-aware analytics
Three ideas to keep in view
Paired test
Run old and new systems on the same cases
Confidence interval
Report a plausible range—not only a mean
Two-layer flags
Separate mechanism enablement from experiment assignment
The book's visual model
Observability technology stack for Agent systems
Scoreboard vs. Evaluation infrastructure
Scoreboard
- One aggregate
- No trace linkage
- Manual reruns
Evaluation infrastructure
- Slices + uncertainty
- Trajectory-level observability
- Repeatable release gates
The purpose of a benchmark report is to generate testable hypotheses.
Pair cases before estimating the delta
deltas = [new[c] - old[c] for c in shared_cases]
estimate, interval = bootstrap_mean(deltas)
if interval.low <= 0: hold_release()
else: canary(new_system)
monitor_slices_and_rollback()
Test the claim
6-3 evidence2 min
Rebuild and audit structured-judge evidence
Observe: Case coverage, immutable source hashes, judge dimensions, and veto records
Demo budget: 2 minutes · one contiguous terminal block
class: course-terminal
Live demo
Switching to the terminal
$ cd chapter6/user-memory-system-evaluation && python build_63_evidence.py
Run the command(s), narrate decisions, and point to the observation—not just the output.
What the evidence supports
Finding 1
Paired case-level analysis is more sensitive than comparing unrelated averages.
Finding 2
Traces make a regression actionable by revealing the failing mechanism.
Finding 3
Evaluation becomes production infrastructure when it controls release and rollback.
layout: center
Where the claim stops
Boundary condition
Statistical significance does not imply practical importance, dataset validity, or simulation fidelity.
layout: center
Engineering takeaway
Design rule
Ship only deltas that are repeatable, practically meaningful, slice-safe, and traceable to a plausible mechanism.
Continue the experiment
Experiment 6-11: AndroidWorld failure analysis
chapter6/android-world/
Experiment 6-12: OpenVLA + RoboTwin2
chapter6/openvla-robotwin2-eval/
Simulation fidelity spectrum
book-en/images/fig6-8.svg
Production evaluation chapter
book-en/chapter6.md
layout: center class: text-center
Pause and apply
Your turn
What would make a statistically significant improvement too small or too risky to ship?
layout: center class: text-center
Chapter 6 complete · Next · Lesson 26
Use the evaluation environment as the practice ground for changing model behavior.
→