Alerts
Alerts
Section titled “Alerts”Set up alert rules to get notified when your agents encounter issues. Alerts are checked automatically after each event is ingested.
Alert trigger types
Section titled “Alert trigger types”| Trigger | Description |
|---|---|
| error | Fires when a run ends with an error |
| cost_threshold | Fires when a run’s cost exceeds a configured threshold |
| waiting_too_long | Fires when an agent has been waiting for human input |
Alert channels
Section titled “Alert channels”| Channel | Target |
|---|---|
| Sends a notification to the configured email address | |
| Webhook | Sends a POST request with JSON payload to a URL |
Webhook payloads include: alert name, trigger type, agent name, run ID, status, cost, token count, and timestamp.
Managing alerts
Section titled “Managing alerts”/alerts — Alert list
Section titled “/alerts — Alert list”View all your alert rules. Each rule shows:
- Name and trigger type
- Channel and target
- Enabled/disabled status
- Last triggered timestamp
/alerts/create — Create alert
Section titled “/alerts/create — Create alert”Create a new alert rule with:
- Name — descriptive label
- Trigger type — error, cost_threshold, or waiting_too_long
- Channel — email or webhook
- Target — email address or webhook URL
- Config — additional settings (e.g., cost threshold amount)
Toggle and delete
Section titled “Toggle and delete”- Toggle — enable or disable an alert without deleting it (
PATCH /alerts/{id}/toggle) - Delete — permanently remove an alert rule
Alert delivery
Section titled “Alert delivery”Alerts are dispatched as background jobs with:
- Up to 3 retry attempts
- Exponential backoff: 10s, 60s, 300s
- Email alerts use the configured Laravel mailer
- Webhook alerts POST JSON to the target URL