Alerts

Set up rules to get notified when your agent encounters an issue, reaches a threshold, or gets updated.

​

Alert rules

Stay on top of agent issues by creating alert rules that notify you automatically when specific events occur. Each rule has a trigger condition (what happened) and one or more notification channels (where to send it).

​

Alert types

​

Status change

Triggers when an agent task enters one or more specific statuses. Select which statuses you want to be alerted on from the multi-select dropdown.

Available statuses

Starting up, Waiting for capacity, Pending approval, Running, Cancelled, Idle, Timed out, Escalated, Unrecoverable error, Paused, Completed, Exhausted retries, Queued for approval, and Queued for rerun.

​

Tool error

Triggers when a tool fails during execution. You can optionally scope this to specific tools — leave the selection empty to watch all tools, or pick individual tools to monitor. This is useful for critical integrations where a tool failure could block your agent’s workflow.

​

Agent published

Triggers when the agent is published. No additional configuration is needed — select a notification channel and you’ll be alerted whenever a new version goes live.

​

Notification channels

Each alert rule can send notifications to one or more channels: For Slack setup details, see Slack integration. For Teams, see Microsoft Teams integration.

​

Setting up an alert rule

1. Navigate to your agent and open the Alerts tab
2. Click Create alert rule
3. Select a trigger type from the left panel
4. Configure the trigger conditions (if applicable)
5. Preview how the notification will look
6. Add at least one notification channel
7. Click Save

You can create multiple alert rules, each with different triggers and channels. Existing rules appear as cards showing the trigger description, active channels, and controls to edit, delete, or toggle them on/off.

---

​

Agent escalations

When your agent encounters a situation it cannot handle, it can escalate the conversation to a human manager using the built-in Escalate to Manager tool. This is different from alert rules — escalation is an in-conversation handoff where the agent actively routes a conversation to a human, rather than a background notification about an event.

​

Enabling the escalation tool

In the Agent escalations section at the bottom of the Alerts page, click Enable escalation tool. This adds the “Escalate to Manager” tool to your agent’s available tools. Once enabled, you can reference the tool in your agent’s prompt using the / command to give the agent guidance on when to escalate. Click Edit prompt to go directly to the prompt editor.

​

When to use escalation