CORE GUIDE
Uncertainty calibration
Useful uncertainty means confidence tracks observed error risk closely enough to change system behavior, escalation and communication.
Mental model
Calibration is a relationship between confidence and outcomes: cases the system treats as more certain should actually fail less often, and uncertainty should trigger a defined policy rather than decorative wording.
Why it matters
Language models can sound equally fluent when correct and incorrect. Asking them to state a percentage does not automatically produce calibrated probability. Applications need empirical evidence about which signals predict failure and a policy for what to do when evidence is weak, conflicting or outside the evaluated distribution.
01
Calibrate signals against real outcomes
Choose a confidence signal that the application can measure, such as verifier agreement, retrieval support, classifier score or ensemble variance. Evaluate it on labeled representative data and check whether higher-confidence bins actually have lower error rates. Then connect thresholds to actions such as answer, request more evidence, abstain or escalate.
02
Example: data extraction with conflicting evidence
An extraction system finds one value in table text and a different value in a nearby note. Rather than output '95% confident', it detects evidence conflict and routes the field to review. Historical evaluation shows that this conflict signal predicts errors far better than the model's verbal confidence.
Common failure modes
- Treating the model's self-reported confidence as calibrated without measurement.
- Hiding uncertainty behind vague phrases while taking the same action anyway.
- Calibrating on easy data and applying thresholds to a shifted production distribution.
Engineering heuristics
- Measure calibration on the same decision slices where thresholds will be used.
- Prefer evidence-based uncertainty signals over confident language.
- Define abstention and escalation as normal outcomes when evidence is insufficient.
Takeaways
- 01Confidence is useful only when it predicts error risk.
- 02Calibration is empirical, not a tone-of-voice feature.
- 03Uncertainty should change what the system does.