Skip to main content

Drift Detection

Drift Detection identifies when an AI agent is stuck — repeating the same actions, looping on failing commands, or making no meaningful progress. Instead of watching your agent spin in circles, UnfoldAI alerts you so you can intervene.

What Triggers Drift Alerts​

UnfoldAI monitors for patterns that indicate non-productive agent behavior, such as repeated modifications to the same files, commands failing multiple times in succession, or extended periods without meaningful progress.

How Alerts Appear​

Drift alerts surface as:

  • Proactive alert messages in the conversation stream with severity level
  • Dashboard cards with agent attribution and suggested actions

Severity levels: Low, Medium, High

Actions​

From a drift alert, you can:

  • Analyze — Get a deeper look at what's happening
  • Generate Report — Create a detailed drift analysis
  • Restore Checkpoint — Revert to before the drift started
  • Dismiss / Monitor — Acknowledge and continue observing

Configuration​

// settings.json
{
  // Enable/disable drift detection
  "unfoldai.driftDetection.enabled": true,

  // Number of repetitions before triggering (3–20)
  "unfoldai.driftDetection.threshold": 6,

  // Minimum severity to trigger proactive alert: "low" | "medium" | "high"
  "unfoldai.proactive.driftSeverityThreshold": "medium"
}

Availability​

Drift detection and alerting are available on all plans. Some AI-powered drift analysis actions may be subject to tier quotas.