# Why one confidence percentage is insufficient
A confidence percentage can look precise but mean different things depending on how it's computed. Token entropy, semantic uncertainty, calibration, and evidence sufficiency each answer a different question. Treat them separately, label them clearly, and design system behavior around the particular question each signal is allowed to influence.
Four distinct uncertainty signals
- Token entropy: a measure of how spread out the model's next-token probabilities are at a given generation step. It describes prediction variability, not factual correctness. High or low token entropy speaks to alternative phrasings or surface certainty in token choice, not whether an asserted fact is true.
- Semantic uncertainty: whether sampled answers disagree in meaning or conclusion. If multiple generations produce different conclusions, semantic uncertainty is high. Agreement among samples indicates consistency in meaning but does not guarantee alignment with reality.
- Calibrated correctness estimate: a statistical mapping between reported scores and observed correctness on a defined task. Calibration tells you how often scores corresponded to being right in past evaluations, not that a specific answer is correct now.
Measurement matters: record the distribution you measured
Tools and sampling choices alter the distributions you observe. Compute entropy on raw logits or on the post-processed distribution after temperature scaling and token filtering? Those are different values. If you show a token probability or a truncated list of alternatives, note that renormalizing produces a distribution over the subset, not full-vocabulary entropy. Label the measurement method and the point in the pipeline where it was taken.
Operational design: give each signal a job
Before exposing confidence indicators, decide three things for each signal: its precise meaning, how you evaluate it, and what operational consequence it can trigger. Examples of consequences include showing a caution, requiring additional evidence checks, routing to a human, or abstaining.
For enterprise assistants: define the claim being evaluated, preserve missing evidence as missing (do not infer it away), and implement a deliberate abstention path when critical evidence is absent. Measure both error rates and the fraction of requests answered so you understand the tradeoff between coverage and safety.
The goal