Trigger agents with email
Learn how to trigger Retool Agents by sending an email.
You can configure an Email trigger for your agent. This enables you, or anyone else that has access to the unique agent's email address, to send an email with a user message that triggers your agent.
When the email of the sender matches a Retool user with use access to the agent, the current_user of the agent is set to that user. When the email of the sender does not match a Retool user with appropriate permissions, the current_user of the agent is set to an admin of your organization.
Refer to the current_user reference for more information.
The following changes occur when setting up an email trigger:
- The Trigger section contains an email address that you can use to trigger your agent.
- An additional set of Instructions is added to tell your agent how to respond to and send emails.
- A Reply to Email tool is added to the list of Tools.
To set up an email trigger for an agent:
- Create a new agent or navigate to an existing agent. Open the Configuration tab.
- In the Triggers section, click + Email.
- Copy the email address and send your agent an email.
You can CC other recipients when sending an email to trigger the agent. Recipients will then also receive the agent's response.