> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bondata.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Failure Alerts

> Get notified when an Agent node fails

Failure alerts automatically notify you when an Agent node encounters an error. Each alert includes the failed Agent, relevant record IDs, success/failure counts, and diagnostic details.

## Set up a failure alert

<Steps>
  <Step title="Open the Agent">
    Go to **Agents** and click on the Agent you want to monitor.

    <Frame caption="Selecting an Agent from the list">
      <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/failure-alerts-1.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=6517a22b1db70547fab258255bf871a4" width="1906" height="448" data-path="images/guide/agents/failure-alerts-1.png" />
    </Frame>
  </Step>

  <Step title="Enable the shield icon">
    Hover over the node you want alerts for and click the **shield icon**.

    <Frame caption="The shield icon on a node">
      <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/failure-alerts-2.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=1ed41bd1207c07a1ba0f4fb0385d71c0" width="632" height="562" data-path="images/guide/agents/failure-alerts-2.png" />
    </Frame>
  </Step>

  <Step title="Configure the Error Route">
    When the shield is enabled, an **Error Route** appears on the node. Click **+** on the Error Route and select an alert action (e.g., Slack Message).

    <Frame caption="Error Route appearing on the node">
      <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/failure-alerts-3.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=4b49de01bdf00e158d4833325531604a" width="359" height="414" data-path="images/guide/agents/failure-alerts-3.png" />
    </Frame>

    <Frame caption="Adding a Slack Message to the Error Route">
      <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/failure-alerts-4.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=ae1fd26c61ece96b975757e6e10a3196" width="779" height="784" data-path="images/guide/agents/failure-alerts-4.png" />
    </Frame>
  </Step>

  <Step title="Set up the alert message">
    Configure the Slack Message node as you normally would. Two dynamic fields are available:

    | Field            | Content                                                 |
    | ---------------- | ------------------------------------------------------- |
    | **Node Summary** | High-level overview of the failure                      |
    | **Task Results** | Detailed execution data (error messages, response info) |

    Drag mentions from Node Summary or Task Results into your message, just like any other mention.

    <Frame caption="Configuring the alert message with dynamic fields">
      <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/failure-alerts-5.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=54f63d2971d0d329a027db2915d511a0" width="228" height="253" data-path="images/guide/agents/failure-alerts-5.png" />
    </Frame>

    <Frame caption="Using Node Summary and Task Results mentions">
      <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/failure-alerts-6.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=5c20b8954a0036c23178fbae50c56d19" width="227" height="323" data-path="images/guide/agents/failure-alerts-6.png" />
    </Frame>
  </Step>

  <Step title="Save and activate">
    Save the Agent and activate it to apply the alert configuration.
  </Step>
</Steps>

## Viewing alerts

<Frame caption="Task list showing alert tasks">
  <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/failure-alerts-7.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=6148ab45414148b339b5136f975b7974" width="409" height="199" data-path="images/guide/agents/failure-alerts-7.png" />
</Frame>

Once configured:

1. **Task List** - hover over the task list (top right) to see tasks generated by the Agent, including alert messages
2. **Task Details** - click any task to expand the full detail view

<Frame caption="Expanded alert task details">
  <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/failure-alerts-8.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=e12b17a12231af50114cce0ef303fad5" width="798" height="908" data-path="images/guide/agents/failure-alerts-8.png" />
</Frame>

3. **Slack** - view the alert directly in your configured channel

<Frame caption="Failure alert message in Slack">
  <img src="https://mintcdn.com/bondata/GMP8l5V0eEm-sA0-/images/guide/agents/failure-alerts-9.png?fit=max&auto=format&n=GMP8l5V0eEm-sA0-&q=85&s=37c8edd3bf5ce9363ca516ee4aa7a4cd" width="710" height="316" data-path="images/guide/agents/failure-alerts-9.png" />
</Frame>

## Example

An Agent creates Salesforce contacts. One node maps the **Full Name** field - but Salesforce requires **First Name** and **Last Name** separately. The record creation is rejected. With a failure alert configured, a Slack message fires immediately with the error details, so you can fix the field mapping.

<Tip>
  Use **Node Summary** for quick alerts and **Task Results** when you need full error details for debugging.
</Tip>
