No Incident Process

Goal Governance Frequency Common Category Governance Published View source on GitHub ↗

Issue: No defined response for agent-caused failures.

Frequency: Common

Symptoms

  • Slow remediation after AI incident.
  • The first response to an agent-caused failure is improvised, with responders unsure whether to pause the agent, roll back a version, or escalate to legal.
  • Standard software incident playbooks don’t cover agent-specific failure modes (hallucinated commitments, runaway tool loops), so responders waste time adapting generic procedures mid-incident.
  • Similar agent failures recur because no post-incident process feeds learnings back into prevention.

Root Cause Standard incident tooling and playbooks are built around infrastructure failures — servers down, latency spikes — and nothing has been written to cover agent-specific modes like hallucinated commitments or runaway tool loops, so on-call responders are left adapting an unfamiliar procedure in real time. Severity is never pre-classified for agent incidents, meaning responders debate priority instead of following a tier, and because no tooling exists to pause a single agent or action type in isolation, mitigation is slower than it needs to be; since post-incident reviews also don’t tag failures against a known pattern taxonomy, each new occurrence is investigated from scratch rather than recognized as a repeat.

Example

An agent handling appointment scheduling begins hallucinating available
time slots that don't exist on the calendar backend, after a tool
integration silently starts returning malformed responses.

The on-call engineer, who normally handles infrastructure outages, has
no agent-specific playbook to reference. They spend 40 minutes trying to
determine whether this is a data problem, a prompt problem, or a tool
integration problem, and another 20 minutes finding someone who knows
how to pause just this one agent without taking down the whole
scheduling service.

By the time the agent is paused, it has confirmed 60 appointments
against slots that don't exist, requiring a full day of manual outreach
to fix.

Contributing Factors

  • No agent-specific incident playbook exists distinct from standard infrastructure incident response.
  • Severity classification for agent failures is ad hoc, so responders debate priority instead of following a pre-defined tier.
  • No tooling exists to quickly pause or throttle a single agent/action type without broader service impact.
  • Post-incident reviews don’t tag failures against known failure patterns, so the same root cause recurs without being recognized.

Eval Recipes

Test Cases

TestInputExpectedFailure Indicator
Playbook match on known failure typeSimulated agent failure matching a cataloged patternResponder is routed to the correct playbook automaticallyResponder has no playbook reference and improvises response
Kill switch responsivenessOn-call triggers agent-specific pause from incident dashboardAgent is paused within target time without affecting other servicesPause requires a full deployment cycle or affects unrelated agents
Post-incident pattern taggingA closed incident reviewIncident is tagged against a known failure pattern taxonomyIncident closes with no pattern tag or playbook-adherence record

Metrics

MetricTargetHow to Measure
playbook_match_rate> 90%Sample recent incidents and check what fraction matched an existing playbook entry
kill_switch_activation_time< 5 minTime a simulated kill-switch activation from trigger to confirmed agent pause
post_incident_tagging_completion_rate100%Audit closed incidents for a completed pattern tag and playbook-adherence note

Mitigation Strategies

Prevention

  1. Agent-Specific Incident Playbook: Author a runbook covering agent-caused failure modes distinct from typical software incidents (hallucinated output sent to a user, unauthorized action taken, runaway tool-call loop, data leak via generated content) with pattern-specific first response steps, decision authority, and communication templates.
  2. Pre-Defined Severity Classification: Establish severity tiers specific to agent incidents (e.g., SEV1: irreversible external action or financial/legal exposure; SEV2: incorrect but reversible action; SEV3: degraded quality with no external action) so responders classify and route immediately instead of debating severity mid-incident.
  3. Incident Response Drills: Run periodic tabletop exercises simulating agent-caused failures (e.g., agent sends an unauthorized commitment, agent leaks PII in a response) so the on-call team has practiced the playbook before a real incident forces first contact under pressure.

Detection & Response

  1. Automated Incident Trigger from Anomaly Signals: Wire agent-specific anomaly detectors (spike in escalations, spike in tool-call failures, output flagged by a safety classifier) directly into the incident management system so an incident ticket opens automatically rather than depending on a human noticing.
  2. Incident Timeline Reconstruction Tooling: Use the agent’s audit trail (trace_id-linked perceive/decide/act logs) to auto-populate an incident timeline showing exactly what the agent saw, decided, and did leading up to the failure, cutting investigation time versus manual log spelunking.
  3. Post-Incident Review with Pattern Tagging: Require every agent incident to close with a retro that tags the failure against a known pattern taxonomy (this catalog’s categories) and records whether the playbook was followed, feeding back into playbook refinement.

Architecture Patterns

  1. Agent Incident Command Structure: Define a lightweight incident commander role for agent incidents with authority to trigger emergency mitigations (pause the agent, revoke a tool’s access, roll back a version) without needing to work through the normal change-management approval chain during an active incident.
  2. Kill Switch Integration: Build a circuit-breaker into the incident response tooling that lets the on-call responder immediately pause or throttle a specific agent, tool, or action type from the incident dashboard, rather than requiring a manual deploy to stop the bleeding.
  3. Incident-to-Playbook Linkage: Tag each incident type in the ticketing system with a direct link to its corresponding playbook section, so responders land on the right runbook automatically instead of searching a wiki mid-incident.

Metrics

  1. mean_time_to_detect_minutes: Target: < 10 min; Alert threshold: > 30 min
  2. mean_time_to_mitigate_minutes: Target: < 30 min (agent paused/action blocked); Alert threshold: > 90 min
  3. incidents_without_playbook_match_percent: Target: < 10%; Alert threshold: > 25%
  4. post_incident_review_completion_rate_percent: Target: 100% within 5 business days; Alert threshold: < 90%

Alerts

  1. Agent Incident Triggered, No Playbook Match (P1 - Critical): Condition - incident opened for an agent failure with no matching playbook entry. Action: Escalate to senior on-call for manual triage, fast-track new playbook creation post-incident.
  2. Mitigation SLA Breach (P1 - Critical): Condition - agent-caused incident remains unmitigated past the target mitigation time. Action: Escalate to incident commander, consider emergency kill-switch activation.
  3. Post-Incident Review Overdue (P3 - Info): Condition - closed incident has no completed retro after 5 business days. Action: Notify incident owner, block related agent changes until retro is filed.

Production Signals

Key Metrics

MetricAlert Threshold
mean_time_to_detect_minutes> 30 min
mean_time_to_mitigate_minutes> 90 min
incidents_without_playbook_match_percent> 25%
post_incident_review_completion_rate_percent< 90%

Alerts

AlertConditionSeverity
Agent Incident Triggered, No Playbook MatchIncident opened for an agent failure with no matching playbook entryCritical
Mitigation SLA BreachAgent-caused incident remains unmitigated past the target mitigation timeCritical
Post-Incident Review OverdueClosed incident has no completed retro after 5 business daysInfo

References

  • NIST-AI-RMF
  • Note: Govern, map, measure, manage framework for AI risk.