For the complete documentation index, see llms.txt. This page is also available as Markdown.

Worker emails

You can interact with your workers via email. Each one of your worker has its own email address and inbox, which can be used to start work or provide input.

Your worker's email is its Custom URL + toolhouse.app. For example, if your worker's friendly name is personal-assistant, you can contact it at personal-assistant@toolhouse.app.

Basic email rules

  • Your worker can only accept emails when its visibility is set to Visible.

  • Everyone who knows the worker's friendly name can send messages to it. You can add strict guardrails on who can interact with the worker using Agent Editor.

  • The worker can reply if its email is in the To or Cc fields of your email. This is useful to Cc your worker on a conversation with others.

  • The worker can read the entire email thread, but it does not read attachments.

Handoff and continuity

Your worker can continue working on a task between email, autonomous work, and chat interface. The worker will remember what task it was working on, even if you're communicating in a separate channel.

  • You can send an email to the worker, then resume work directly in Toolhouse.

  • You can start work in Toolhouse, then pick up when you left off via email.

  • The worker can start autonomously, then send you an email for approvals.

Set up the email name

  1. Go to the Agents page

  2. Click on the worker you want to change.

  3. Click Details.

  4. In the Custom URL section, type the address you want.

You can change your worker's address at any time. When you do so, you will make the old email available to other customers. Also keep in mind that we enforce these naming rules:

  • Your worker's email can be 2-50 character long

  • It can only contain lowercase letters, numbers, and dashes

  • It cannot start or end with a dash

  • It cannot contain profanity

  • It cannot contain reserved words

Last updated