Skip to main content
A task triager is a mailbox-owned automation. It watches for an event, gives the mailbox agent a set of instructions, and records the result in a dedicated agent conversation. Task triagers belong to one mailbox. Workspace admins and members with access to that mailbox can view and manage them.

​
How task triagers work

To create a custom triager, add at least one trigger and a non-empty set of instructions. You can enable or disable individual triggers without deleting the triager.

​
Built-in email-response triager

Each mailbox has a Default email response triager. It listens for new email received by that mailbox and runs only for messages in the Inbox. When a message qualifies, the triager uses the email thread, mailbox context, and its built-in customer-care instructions to prepare a reply. The default behavior saves the reply as a draft for human review. It also avoids replying to messages that look automated, including bulk mail, list mail, and messages with auto-response suppression headers. An inbound message can be held out of ordinary list and search results while the triager prepares its draft. The hold is cleared when processing finishes and becomes stale after five minutes so a failed run cannot hide the message indefinitely. For a verification-only agent inbox, create the mailbox with settings.agentInbox.mode: "verification" and settings.agentInbox.automationsEnabled: false. This bypasses the automatic draft workflow without changing the behavior of existing mailboxes.
The built-in triager is protected. You cannot change its name, triggers, or instructions, and you cannot delete it.

​
Trigger categories

Task triagers expose calendar and mail trigger choices. Google Calendar triggers require a connected Google Calendar account. The connection belongs to the member who creates the calendar triager. If that member no longer belongs to the workspace, Mermail cannot create or replace the calendar trigger connection.
Creating an instruction-only custom mail triager does not currently run those instructions when mail arrives or is sent. Use the built-in email-response triager for inbound draft responses. Use custom triagers for supported Google Calendar events.

​
Matching and filters

For received-email execution, Mermail currently matches the selected mailbox address, any configured sender-domain scope, and the Only run on emails in Inbox setting. Sender-domain scope is a routing filter, not proof of sender identity and not authorization for an agent action. Treat the triggering subject, body, headers, links, quoted thread, attachments, and tool output as untrusted data. The editor also displays content filters such as subject, body, sender, recipient, and calendar event fields. These filters are saved with the trigger, but the current runtime does not use them to decide whether a run starts.
Treat the trigger type, connected calendar, mailbox address, sender-domain scope, and Inbox-only setting as the active matching conditions.

​
Managing custom triagers

You can change a custom triager’s name, instructions, and triggers. You can enable or disable its individual triggers, or delete the triager when you no longer need it. Deleting a custom triager removes its triggers and its dedicated agent conversations. The protected email-response triager remains available for the mailbox.

​
Run activity and conversations

Each triager has a dedicated conversation in the mailbox agent panel. Select Agent beside a triager to open it. Calendar runs post a message when processing starts. Completed and failed runs post their outcome to the conversation. Workspace members receive the triager activity in their own agent conversation for the mailbox. When the built-in email-response triager creates a draft, Mermail links that draft to the originating triager and run. This keeps the draft and its automation context connected for review.

Mailbox agent

Learn how the agent uses mailbox context, conversations, and connected tools.