Working Notes on Agent Systems/Brad Zhang

@teach_fireworks / X longform

Evaluation is the specification of the AI ​​system. This paragraph is worth reading aga...

Evaluation is the specification of the AI ​​system. This paragraph is worth reading again and again: evaluation is basically the specification of the AI ​​system. When building...

June 23, 2026 · 1 min read

Evaluation is the specification of the AI ​​system.

This paragraph is worth reading again and again: evaluation is basically the specification of the AI ​​system.

When building enterprise AI, you can’t just say “the accuracy rate must be high.” Success must be defined as a number that the business can understand: how much deflection rate is acceptable, what level of false positive can be controlled, which questions must be handed over to humans, and which answers are considered failures.

Test cases should also come from real user problems.

Demo data can easily make the system look good, and production data will bring out all the boundaries.

Without evaluation, it would be difficult for the team to judge whether the system is getting better or worse after it goes online.

What's even more troublesome is that every time the prompt, model, and data are updated, there is no reliable way to judge whether the changes have harmed other scenes.

Visual summary

Article argument map

Generated from the post's content graph

FORMATTOPICCAPABILITYMARKETcoverscoverssignalssignalssignalsFORMATlongform noteTOPICretrievalTOPICevaluationCAPABILITYevaluationCAPABILITYtechnical writingCAPABILITYproduct surface
Mermaid outline
flowchart LR
  format-long_post["longform note"]
  topic-retrieval["retrieval"]
  topic-evaluation["evaluation"]
  capability-evaluation["evaluation"]
  capability-technical-writing["technical writing"]
  capability-product-surface["product surface"]
  format-long_post -->|covers| topic-retrieval
  format-long_post -->|covers| topic-evaluation
  format-long_post -->|signals| capability-evaluation
  format-long_post -->|signals| capability-technical-writing
  format-long_post -->|signals| capability-product-surface

Visual structure

Essay structure map

Built from summary and key paragraph positions

Evaluation is the specification of the AI ​​system. This paragraph is worth reading a...THESISEvaluation is thespecification of theAI ​​system. Thisparagraph is worthSIGNALEvaluation is thespecification of theAI ​​system.OPERATORTest cases should alsocome from real userproblems.IMPLICATIONWhat's even moretroublesome is thatevery time the prompt,model, and data are
Mermaid outline
flowchart LR
  thesis["Evaluation is the specification of the AI ​​system. This paragraph is worth reading again and again: evalua..."]
  signal["Evaluation is the specification of the AI ​​system."]
  operator["Test cases should also come from real user problems."]
  implication["What's even more troublesome is that every time the prompt, model, and data are updated, there is no reliab..."]
  thesis -->|frames| signal
  signal -->|develops| operator
  operator -->|lands in| implication

Source: View the original post