How do I create a Notify Users action tool for AI agents?

Last updated: November 5, 2026

Create a Notify Users action tool when an AI agent should alert one or more teammates during a conversation.

Before you start

  • Decide which users should be notified.

  • Define the exact event or condition that should trigger the notification.

Steps

  1. Open Agents.

  2. Select Tools, then Create Tool.

  3. Choose Execute Actions.

  4. Name and save the tool.

  5. Add a clear label and description.

  6. Set timeout and speech settings.

  7. Add a Notify Users action.

  8. Select the users to notify.

  9. Enter the notification message or prompt instructions.

  10. Save the action and tool.

  11. Enable the tool on the agent.

  12. Update the agent instructions with when to notify users and what context to include.

Troubleshooting

  • If users are not notified, confirm the tool is enabled on the agent.

  • If notifications lack context, update the message or agent instructions.