Distribution Shift
Production Queries Differ Significantly from Golden Dataset
8 patterns for this goal
Agents pass evaluation on golden datasets but fail systematically in production because the test dataset doesn’t represent production’s actual distribution, contains stale or mislabeled data, or measures the wrong metrics β the evaluation score doesn’t predict real-world performance, creating a false sense of readiness. These failures are silent: evaluation reports look good, so decision-makers trust the agent to production, where it fails on query types the golden set didn’t cover.
Across all 8 patterns, the single most reliable mitigation is systematic coverage analysis: before evaluation, analyze production’s actual distribution and ensure golden-set composition matches it, with explicit oversampling of high-stakes edge cases, rare conditions, and minority segments. The second universal mitigation is disaggregated performance tracking β report accuracy overall and separately for each segment (language, geography, query type, complexity level) so coverage gaps and distribution shift surface as breakdowns in specific segments rather than being masked by overall-accuracy averages. If evaluation reports only a single aggregate score, the gaps are invisible.
Evaluation reliability covers testing methodology and golden-data quality β whether the test dataset accurately represents production. Verification failures cover how agents validate their own outputs at runtime. See Verification for testing approaches; evaluation reliability is the upstream problem that testing approaches should catch.
Larger golden sets help but don’t eliminate coverage gaps β a 10,000-example set with poor distribution representation is worse than a 1,000-example set systematically stratified across segments. The issue is composition (coverage of important segments), not just size. A convenience sample scales the bias rather than fixing it.
Retraining helps, but the core issue is golden-set staleness β if the test data is outdated, retraining on outdated production labels propagates the stale distribution into the new model. The fix is to refresh the golden set itself, not just retrain against a stale golden set.
Disaggregate production performance by the metric you care about and compare against evaluation scores for the same metric. If evaluation reports 94% accuracy but production shows 94% on common queries and 58% on edge cases, the aggregate metric was masking the gap. Watch for divergence between metrics (e.g., precision looks good but recall terrible) that the primary evaluation metric didn’t capture.
| Pattern | Mechanism |
|---|---|
| Distribution Shift | Production queries differ from golden-set distribution; coverage perfect for old distribution but gaps emerging for new |
| Evaluation Data Leakage | Test data contaminated by training data; evaluation score is optimistic because model saw test examples during training |
| Evaluation Metric Mismatch | Evaluation uses wrong metric; high score on metric doesn’t predict success on actual production goal |
| Golden Data Coverage Gaps | Test set missing critical scenarios (edge cases, rare conditions, minorities); good eval score, poor production performance |
| Golden Data Staleness | Test data created months ago; production evolved (new features, trend changes, policy updates) but golden set unchanged |
| Label Noise and Errors | Golden-set labels incorrect or inconsistently applied; evaluation score reflects label quality, not agent quality |
| Overfitting to Evaluation | Agent optimizes for evaluation metric rather than production goal; high eval score masks misalignment between metric and actual value |
| Semantic Equivalence Failures | Metric treats semantically different outputs as equivalent; evaluation score hides quality gaps the metric doesn’t capture |
Total: 8 patterns
Production Queries Differ Significantly from Golden Dataset
Golden Data Contaminated Training or Model Has Seen Eval Cases
Metrics Don't Measure What Actually Matters for Success
Golden Dataset Missing Critical Scenarios or Edge Cases
Golden Dataset Contains Outdated Information or Expectations
Golden Dataset Contains Incorrect Expected Responses
Agent Optimized for Eval Set, Fails on Real Queries
Correct Answers Marked Wrong Due to Different Wording