Human review workflows and confidence calibration
What this covers
- See why an aggregate accuracy figure can hide a broken segment
- Use stratified sampling to monitor high-confidence output
- Calibrate field-level confidence against labeled data
- Break accuracy down by document type and by field before reducing review
- Route review by calibrated uncertainty, source ambiguity, and business impact
Key terms
- Validation set
- Examples kept separate from development and used to measure how well a system works.
Overall accuracy can hide weak document types
97% overall accuracy can conceal one document type at 60%, or one field that is often wrong. Common document types have the greatest effect on the overall average, so weak performance on a rare type may be difficult to see.
Analyze accuracy by document type and by field before reducing human review. Check both the overall score and the performance of each important group.
The same 97%, broken out:
document type volume accuracy
standard invoice 9,400 98%
credit note 380 94%
handwritten receipt 220 61%
all types 10,000 97%The arithmetic works: 61% on 220 documents barely moves an average dominated by 9,400. Two percent of your volume is wrong four times out of ten, and the headline number reports that as healthy.
Sample the confident cases
Reviewing only low-confidence extractions leaves high-confidence results unmonitored. Some of those automatically accepted results may still be wrong.
On an exam you re-check the questions you struggled with and skip the ones you were sure about. The marks you lose to carelessness sit in the second group, because certainty is what stops you looking. Sample the confident cases for the same reason.
Stratified random sampling of high-confidence extractions measures the error rate where you are not looking, and — more valuable — detects novel error patterns as documents change. A supplier changing their invoice layout produces confident, wrong extractions, and sampling is what surfaces it.
Stratification matters as much as randomness. A format representing 0.5% of traffic contributes about one document to a random sample of 200. Tripling the sample produces only about three examples at triple the review cost. Sample each important document type separately instead.
Two cheaper-looking substitutes don't work either. Reviewing whatever a downstream system rejects catches only errors that break something, and a plausible wrong value passes every structural check. Re-running old documents tests whether results are stable, and a stably wrong extraction looks perfectly healthy.
Validate confidence scores before using them
Have the model output field-level confidence scores, then compare those scores with known correct and incorrect results in a labeled validation set. This process, called calibration, shows what each confidence range means in practice and helps you choose review thresholds.
A calibration describes the documents it was fitted on. When a supplier redesigns its layout, the validation set holds no example of the new format, so refitting on that same set says nothing about these documents. New formats need newly labeled examples before their thresholds mean anything.
Route by capacity
Reviewer capacity is limited. Use calibrated confidence, source ambiguity, and business impact to decide which results need human review. Also review a sample of results that would normally be accepted automatically. This sample can reveal errors that the routing rules missed.
stratified samplingfield-level confidencevalidation sets
Field note — common misconceptions
- MythThat a high overall accuracy justifies automation
- ActuallyAn aggregate hides segments: analyze accuracy by document type and by field before automating.
- MythThat high-confidence extractions no longer need sampling
- ActuallyStratified sampling of high-confidence output can catch errors caused by a supplier's new layout.
- MythThat raw model confidence is calibrated
- ActuallyCalibrate field-level scores against a labeled validation set before setting review thresholds.
Guided review
Review this lesson as a study deck
Review the lesson's main ideas in five guided slides, then test yourself with three flashcards.
Open Task 5.5 study deckCross-domain reasoning
Connect this idea
Evaluation continues through delivery
Clear criteria, examples, repeated testing, continuous integration, independent review, and human review all provide evidence that a change works as intended.
- 3.5 · Apply iterative refinement techniques for progressive improvement
- 3.6 · Integrate Claude Code into CI/CD pipelines
- 4.1 · Design prompts with explicit criteria to improve precision and reduce false positives
- 4.2 · Apply few-shot prompting to improve output consistency and quality
- 4.6 · Design multi-instance and multi-pass review architectures
Applied practice
Practice this lesson in a lab
Use a related lab to create a decision, implementation or diagram, evidence record, and review.
- Lab 7 · CI review with a strict output contract
Make a review job distinguish a clean diff from malformed output, execution failure, and invalid evidence.
- Lab 8 · Structured extraction and batch evaluation
Compare extraction strategies against labeled synthetic data without hiding critical-field failures.
- Lab 10 · Reliability, provenance, and escalation evaluation
Evaluate autonomy, escalation, failure propagation, and claim-level provenance across a synthetic scenario suite.