Trigger agents with email
Learn how to trigger Retool Agents by sending an email.
| Retool Agents Availability | |||
|---|---|---|---|
| Cloud-hosted | Public beta | ||
| Self-hosted (3.272 Edge) | Public beta | ||
| Self-hosted (3.196 Stable and later) | |||
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. Treat the agent's email address as sensitive information.
If the sender's email address matches that of a Retool user with use access to the agent, current_user reflects that user and the agent can only use tools to which the user has access.
If the sender's email address does not match any Retool user with appropriate permissions, the agent falls back to an organization admin. Retool strongly recommends that you only allow known Retool users with access to the agent to use email triggers.
Refer to the current_user reference and the Manage permissions page 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.