systemdesign.academyAI EngineeringFree lessonsSign inGet the course
  1. Home
  2. AI Engineering: Evaluation, LLM Ops and Security
Previous lessonWhy Evals Are the Job: Moving From Vibes to MeasurementNext lessonBuilding a Golden Dataset: The Set That Catches Regressions

System Design

  • Foundation
  • Intermediate
  • Advanced
  • Capstone

AI Engineering

  • Foundation
  • Data, RAG and Agents
  • Evaluation, LLM Ops and Security

systemdesign.academy

  • Home
  • Glossary
  • Interview prep
  • Reviews
  • About
  • Pricing
  • Privacy
  • Terms
  • Refunds
  • Delivery
  • Contact
  • LLM Evaluation and Error Analysis
  • Error Analysis: Reading Failures Before Building Metrics
  • AI Engineering · Evals

    Error Analysis: Reading Failures Before Building Metrics

    Free preview: the first part of this 12-part lesson.

    Already bought the course? Sign in to read the whole lesson.

    this lesson is part of

    AI Engineering

    Unlock this lesson and the 199 other paid lessons

    • 210 lessons in 16 chapters
    • 118 lessons built on a lab that really ran
    • An AI tutor beside every lesson that answers and draws
    • Lifetime access, every new lesson included

    $49 once, by PayPal

    See the AI Engineering course

    The rest of this lesson

    1. Error Analysis Is Just Reading Your Data, on Purpose
    2. Why Metrics and Dashboards Sit on Top, Not at the Bottom
    3. Open Coding: One Trace, One Plain Note, No Categories
    4. Axial Coding: Let the Categories Come Out of the Notes
    5. When Do You Stop Reading? Theoretical Saturation
    6. Label Pass or Fail, Never Rate 1 to 5
    7. The Highest-Leverage Thing You Will Build Is a Way to Look
    8. Watch a Pile of Notes Become a Ranked Taxonomy
    9. The Honest Cost, and When You Can Lean on It Less
    10. Who Actually Works This Way
    11. Knowledge Check

    read the rest of this lesson in

    AI Engineering

    Unlock this lesson and the 199 other paid lessons

    • 210 lessons in 16 chapters
    • 118 lessons built on a lab that really ran
    • An AI tutor beside every lesson that answers and draws
    • Lifetime access, every new lesson included

    $49 once, by PayPal

    See the AI Engineering course

    Continue this lesson

    in Evals

    This lesson is part of the AI Engineering course. Unlock the full course, a separate one-time payment, for lifetime access.

    One-time payment. Lifetime access. No subscription.
    Global
    $49/lifetime

    One-time payment via PayPal

    Get Lifetime Access
    Foundation lessons free, try before you buy
    India Special
    India
    ₹999/lifetime

    One-time payment: UPI, card or netbanking

    Get Lifetime Access
    Foundation lessons free, try before you buy
    Every ML Platform lesson, Foundation to Advanced
    Real architecture diagrams with real tool logos
    MLOps, LLMOps, and data engineering in depth
    Quizzes with instant feedback
    Built and reviewed by senior engineers
    Lifetime access, all future content included

    Foundation lessons of this course are free, no payment needed. Try them now

    The Team That Built a Dashboard and Still Could Not Say What Was Wrong

    The dashboard is green. Average helpfulness 4.2, average correctness 4.4, tone 4.5, each scored by an LLM judge reading every reply on a 1 to 5 scale. Two weeks after launch the support agent still feels off to everyone who uses it, and nobody can say more than that. The green numbers and the felt wrongness cannot both be right, and the numbers are winning the argument only because they are numbers.

    An illustrated scene of a team in front of a dashboard, with the scores beside it: helpfulness 4.2, correctness 4.4, tone 4.5, every reply graded by a judge on a 1 to 5 scale. The text notes that two weeks after launch the agent still feels wrong to everyone using it and customers still escalate, and that the answer was sitting in the logs the whole time because nobody had read them

    The agent is still bad. Customers still escalate. The dashboard says 4.2 and the support queue says otherwise, and now the team trusts the dashboard less than they trust the queue. They spent three weeks building measurement infrastructure and they still cannot answer the one question that matters: what, specifically, is this thing getting wrong, and how often?

    Here is the part that stings. The answer was sitting in the logs the entire time. They had thousands of real traces, the actual inputs and the actual replies, and nobody had read them. They jumped straight to metrics because reading transcripts by hand felt like the unglamorous part, the part a real engineer automates away. So they automated away the one step that would have told them what to measure.

    A metric is an answer to a question. If you have not read your failures, you do not yet know the question, so every metric you pick is a guess dressed up as rigor.

    The deeper problem is that they tried to leap from a feeling to a number without building anything to carry them across. Evaluation lives between two worlds. On one side is the qualitative work of a human reading messy outputs and forming a judgment in words. On the other is the quantitative world of counts and dashboards. There is a crossing between them, and skipping it drops you in the water.

    Two columns showing the two worlds evaluation sits between. On the left, words: a person reading messy output, forming a judgement in sentences, rich and specific and impossible to put on a chart. On the right, counts: rates, deltas and gates, easy to plot and meaningless unless somebody first decided what is being counted. A line between them notes that the team in the first slide jumped straight from the left to the right

    This lesson is about the crossing they skipped. Before you build a single metric or dashboard, you read real failures, by hand, and you let them tell you what your evals should measure. Hamel Husain teaches this to teams for a living, and he is blunt about the ratio. Most of the real work in evals, on the order of 60 to 80 percent, is this reading and analysis. The infrastructure is the rest. The infrastructure is the easy 20 percent, and it is worthless pointed at the wrong target.

    A bar chart of where the work in evals actually goes, showing reading and analysis at 60 to 80 percent against building the infrastructure at 20. The note beneath says the infrastructure is the part that photographs well, so it is the part teams start with, and it is also the easy fifth. A warning marks the split as an experienced practitioner's estimate rather than a measurement, present for the shape of the ratio and not the exact number

    Sit with the ratio for a second, because it is the opposite of how most teams plan the work. The part you can put in a sprint ticket, the judge and the dashboard and the CI wiring, is the small end. The part with no ticket, sitting and reading your own output, is most of it. That is also why it gets skipped: it does not look like engineering while you are doing it.