Skip to content
Clairos Learn

Incident response and capstones · Lesson 2 of 12 · 9 min

Investigate inference errors

Inference error triage distinguishes rejected inputs from runtime failures. Group by status and request ID before choosing a retry or configuration change.

Mastery 0/3Run itExplain itApply it
learner@clairosSimulated AI Ops lab
learner@clairos:~ $
↑ history · Tab complete · Ctrl+C cancel · Esc, Tab to leaveExit 0

Understand the pattern

Inference error triage distinguishes rejected inputs from runtime failures. Group by status and request ID before choosing a retry or configuration change.

Interpret the evidence

Fix the missing model field driving most errors before retrying unchanged requests.

A tempting mistake

Treat 98 validation errors as transient capacity failures.

All names, measurements, prices, versions, and thresholds in this exercise are fictional training data. The evidence supports this bounded scenario, not a claim about a live provider.

Worked example and expected result
$ cat /opt/ai-lab/cases/aiops-incidents-capstones-002.json
{
  "fixture": "Fictional training data; not a live measurement.",
  "errors_400": 98,
  "errors_503": 2,
  "most_common_error": "missing model"
}

Exit status: 0. The command completed successfully in the training fixture.

$ jq .most_common_error /opt/ai-lab/cases/aiops-incidents-capstones-002.json
"missing model"

Exit status: 0. The command completed successfully in the training fixture.

$ printf '%s\n' 'fix-client-model-field' > /home/learner/lab/aiops-incidents-capstones-002-decision.txt
(no output; exit 0)

Exit status: 0. The command completed successfully in the training fixture.

Try a variation

Name the assumption that would have to change for “fix-client-model-field” to stop being the justified action. Do not silently replace missing evidence with a guess.

Explain it

What does the evidence in “Investigate inference errors” justify?

Apply it elsewhere

A colleague concludes: “Treat 98 validation errors as transient capacity failures.” What should you do?

Keep the momentum.

Complete the lab, then explain and apply the pattern.

Next: Diagnose retrieval regressionTry an incident drill

Anonymous lesson and mastery progress lasts for this session. Sign in to keep synced lesson XP between sessions; mastery stays device-local. No speed bonus, lost lives, or hint penalties.

Keep learning

  1. 01Triage elevated latencyLatency triage starts with a scoped symptom, then traces its largest contributor. Separate the evidence from the hypothesis and prefer a reversible next action.Practice
  2. 02Diagnose retrieval regressionA retrieval regression should be compared against corpus, embedding, filters and index revisions. Find the changed boundary before tuning unrelated generation settings.Practice
  3. 03Review a prompt rollout incidentA prompt incident can appear as a semantic regression rather than a process crash. Compare revisions and evaluation evidence while preserving a known-good rollback.Practice