Track 05 · EvalsLesson 10 of 10
Catching drift before the customer does
Spot slow quality decline as data, usage and models shift underneath.
- Lesson library · reference
- 40 min read
- 60 min hands-on
- Pro
What you'll be able to do
01- Explain the kinds of drift that degrade an agent in production (input, concept, upstream model, retrieval corpus, prompt and configuration, user behaviour) and give a detection signal for each.
- Implement a population stability index (PSI) over categorical distributions and a control chart with run rules over a daily quality score, with no dependencies.
- Design alerting that catches real regressions within days while keeping false alarms rare enough that people still read the alerts.
- Plan scheduled re-evaluation and a model deprecation playbook using the providers' published notice policies.
- Connect drift detection to the feedback loop: triage, review, fix, new golden cases, CI gate, verified release.
- Defend a monitoring plan to an operations lead and a model-risk reviewer who both want "no surprises".
Before you start
- Golden datasets and the metrics that matter: the reference set you re-run and refresh.
- Regression tests and CI gates: every fix for drift goes through the gate.
- Online evals, A/B tests and flags: online judge scores and signals are the raw material for drift monitoring.
- Human review and feedback loops: reviewers confirm what alerts suggest.
- Querying a month of traces: the queries you run when an alert fires.
- Acceptance criteria and sign-off: drift is measured against what was signed.
The short version
A signed, working agent will get worse without anyone changing its code. Users start asking about a product launched after your golden set was frozen. A policy changes, so last quarter's correct answer is now wrong. The provider updates or retires the model. Someone replaces a document in the knowledge base. A prompt is edited outside the registry. Users trust the system more and check it less. None of this throws an error; the agent keeps answering. You catch it by monitoring distributions and quality over time: the mix of intents and languages (PSI is a simple, explainable measure for categorical mixes), embedding-based shift and new-cluster rates for free text, online judge scores, guardrail hit rates, feedback, escalations and outcomes. Put quality metrics on control charts rather than fixed thresholds, so alerts fire on real shifts and not on daily noise, and send one notification per episode rather than one per day. Re-run the golden set on a schedule even when nothing has changed, refresh it from production with current labels, and keep a model deprecation playbook tied to the providers' notice periods. Every confirmed drift ends as new golden cases and a gated fix.
- Drift is the default. Plan to detect it; do not hope to avoid it.
- Watch inputs, outputs, outcomes and the system, because each kind of drift shows up in a different place first.
- Use statistics that respect noise. Control charts and minimum sample sizes beat hand-picked fixed thresholds.
- Re-evaluate on a schedule, not only on change. Upstream changes do not open a pull request in your repo.
- A retirement notice starts a project, not a config change. Budget time for evaluation and re-approval.
Pro lesson
The rest of this lesson is in Pro.
The mental model, worked example, field note, failure table, exercise and self-check, with the voice tutor.
- Every stage and specialisation, in full
- Every lab and every role project
- Halden weeks 2–10, on your record
- Every drill, live in the playground
- All solutions, plus the server judge
- Lab Assistant and every Teach with AI