AI guide
【One-Line Pitch】
A practical field guide to replacing guesswork with systematic measurement in LLM applications, showing engineers and technical leads how to find, quantify, and fix the failures that matter in production. Best for software engineers, technical PMs, and leads who already ship AI features and need a repeatable evaluation process rather than academic benchmarks.
【Book Arc】
- **Opening (~0%–9%)**: Frames the core problem—LLM adoption has outrun our ability to tell whether these systems actually work—and introduces the Analyze-Measure-Improve lifecycle as the book's organizing spine.
- **Early (~9%–33%)**: Lays foundations: what evaluation means for LLM applications, the distinction between the agent and the surrounding application, and the Three Gulfs framework (comprehension, specification, generalization) for diagnosing where things break.
- **Middle (~33%–52%)**: Moves into the Analyze phase, contrasting intrinsic pretraining metrics like perplexity with application-level evaluation, and uses concrete cases (email triage, travel planning) to show how comprehension and specification gaps surface in real data.
- **Late (~52%–80%)**: Covers the Measure phase—implementing automated evaluators, LLM-as-a-judge, synthetic data generation, and handling specific architectures such as RAG, multi-turn conversations, and agentic systems (excerpts do not cover these chapters in detail).
- **Ending (~80%–100%)**: Production and improvement: continuous integration, monitoring, human review interfaces, cost optimization, and closing the loop from evaluation back into systematic improvement (excerpts do not cover these chapters in detail).
【Key Takeaways】
- **Evaluation is a lifecycle, not a metric** (Early): The Analyze-Measure-Improve loop structures everything—analyze failures first, then measure, then improve against a baseline.
- **The Three Gulfs explain why agents fail** (Early–Middle): Comprehension (developer vs. real data), specification (intent vs. prompt), and generalization (training vs. production) give you a diagnostic vocabulary before you reach for fixes.
- **Separate the agent from the application** (Early): Some failures come from the LLM component (wrong tool call, bad format); others from surrounding infrastructure (UI, data, latency). This book targets agent-level evaluation.
- **Application-centric evaluation beats public benchmarks** (Middle): Academic leaderboards rarely represent your contract-review or medical-summary task; you need evaluation tailored to your own goals and data.
- **Principles outlast tools** (Early): Define "good output," break quality into observable dimensions, build datasets matching real use, and combine automated checks with human judgment—these survive model churn.
- **Techniques move fast; expect lag** (Early): AI-assisted error finding, trace sampling, LLM judge validation, and agent-proposed test cases are all evolving, so treat implementation details as perishable.
- **Failure has real consequences** (Early): The Air Canada chatbot case shows an unevaluated agent producing a hallucinated policy that a customer relied on—and the company was held liable.
- **Start from your data, not from model choice** (Early): Prototype with real application data, then use these techniques to judge whether a given model meets your requirements.
【Reading Tips】
- Read Chapters 1–2 first even if you plan to jump around; the Three Gulfs and lifecycle framework underpin every later chapter.
- Engineers should deep-read the Measure and Production parts for implementation detail; PMs can focus on error analysis, collaborative evaluation, and the strategic lifecycle framing.
- Skim the pretraining/post-training background if you already know it—its value is understanding which post-training method shapes the errors you'll see.
- Treat the technique chapters as a menu, not a script: pick the evaluator or sampling approach that fits your current stage (no user data vs. scaling production).
- Keep the principles list handy as a checklist; it's the part designed to stay useful as models and tooling change.
【Coverage Limits】
This guide is synthesized from stratified excerpts covering roughly the first half of the book; the Measure, Production, and Improvement chapters are referenced by structure and stated goals but not by detailed content, so specifics on RAG, multi-turn, agentic evaluation, monitoring, and cost optimization are not covered here.
Passage locations
Excerpt 1
ow to measure what matters in production and keep improving. Willis Vandevanter, AI security engineer, Terra Security Most teams reach for metrics before the...
View in text
Excerpt 2
to fold the advances that prove durable into later editions. We work on evals almost every day, and we keep our live course current as we meet new failure mo...
View in text
Excerpt 3
at nobody caught the failure before a customer relied on it. This is the kind of issue that evaluation is designed to surface: a systematic check of the chat...
View in text
Excerpt 4
checking compliance will require its own evaluation methods. Responsibility therefore falls to the application development team to define what success means,...
View in text