Files
ai-agent-book/slides/lesson-25.md
T
liqiang b119135836
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
ai-agent-book 精选快照(<2MB 代码与文档,来自 github.com/bojieli/ai-agent-book)
2026-08-20 13:12:50 +00:00

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
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


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.