Overview
Email Agents allows you to assign a dedicated email address to any AI agent in your workspace. Users with platform accounts can then email the agent directly and have natural back-and-forth conversations, with full context retention across threaded replies. The agent can read attachments, generate responses, and send files back, all through standard email.
Who this is for
Teams looking to integrate AI assistance into existing email-based processes
Prerequisites
Email Agents feature must be enabled for your organization
You must have permission to create or edit agents in Workshop
Setting up an Email Agent
Steps for admins
Open Workshop and navigate to the agent you want to configure (or create a new agent).
Go to the Configuration tab and locate the "Agent Email Address" field.
Enter the local part of the email address (e.g.,
support,intake,help). The system automatically appends@agents.hatz.aito create the full address.Check availability — The platform validates in real-time that the address is not already taken. Each email address must be globally unique across the platform.
Save the agent — Once saved, the agent is immediately live and can receive emails at that address.
Expected results
The agent will appear with its email address in the agent configuration. No additional DNS, email server, or infrastructure setup is required—all email handling is managed by the platform.
Who can email your agent?
Anyone in your organization who has a Hatz account. That's it. You just need to share the agent with your team first (one click), and then anyone on your team can email it like they'd email a coworker.
People outside your organization, or people who don't have a Hatz account, can't use it — their emails will just be ignored.
The agent must be **shared** with your organization (or with specific groups). A private agent can only be emailed by its creator.
How end users interact with Email Agents
Sending an email to an agent
Compose an email to the agent's address (e.g.,
[email protected]).Include your message in the subject and body. You can attach files if needed (PDF, DOCX, images, etc.).
Send the email from the email address associated with your platform account.
Agent responses
The agent will:
Read and process your email content and any attachments
Apply its configured instructions, knowledge, and tools
Reply via email with a generated response
Maintain the email thread so replies stay organized in your inbox
Reply to all original recipients (To and CC), excluding itself
Continuing conversations
Simply reply to the agent's email to continue the conversation. The agent retains full context of the thread, so you can have natural multi-turn exchanges without repeating information.
Attachments
You can send attachments to the agent (documents, spreadsheets, images), and the agent can send files back (generated reports, charts, documents, etc.).
Each email thread maps to a single chat conversation in the platform, stored with full message history.
Attachment support
Inbound attachments (user to agent)
Supported formats: PDF, DOCX, XLSX, CSV, TXT, JSON, HTML, Markdown, PPTX, images (JPG, PNG, GIF, WebP)
Limits:
25 MB total per email
Text documents: 50,000 characters per attachment, 200,000 characters total
Images: 5 MB per image (processed as vision inputs)
Outbound attachments (agent to user)
The agent can send any file it generates (documents, spreadsheets, charts, etc.) with a limit of 10 MB per attachment.
Troubleshooting
Agent not receiving emails
Verify the email address — Confirm you're sending to the correct agent email address shown in Workshop
Check sender account — Your sending email must match the email address in your platform profile
Wait briefly — Email processing typically completes within seconds, but may take up to a minute under high load
Emails from external users not working
Email Agents only accept emails from registered platform users. The sender's email address must match a profile email your Hatz tenant.
No reply received
Check your spam folder
Confirm the agent is still enabled and the email address is active in Workshop
Verify your email wasn't flagged by spam filters during send
What Email Agents cannot do
Custom domains — All agent email addresses must use the platform's
@agents.hatz.aidomain. You cannot use your own organization's email domain.External user access — Only users with active platform accounts can email agents. Emails from unknown or unregistered senders are ignored.
Email-specific UI — Email conversations appear in the chat interface like regular chats. There is no visual indicator showing which messages originated from email versus the web interface.
Email templates — Agent replies are generated entirely by the AI based on its instructions. Admins cannot create or configure email response templates for agents.
Constraints and requirements
Global uniqueness — Each email address can only be assigned to one agent across the entire platform
Sender verification — The sender's email must match a registered profile email in the platform
AI disclaimer — Every agent reply includes the footer: "This email was generated by a Hatz AI agent."
Security restrictions — All emails are scanned for spam and viruses; failed messages are silently dropped
Concrete Use Cases That Click
"The New Hire's Best Friend"
New employees are afraid to ask "dumb" questions. Give them [email protected]. They email it about PTO policies, benefits enrollment, office locations — and get instant, accurate answers from your company knowledge base. They can reply with follow-ups and the agent remembers the whole thread.
"The Deal Desk Analyst"
Sales rep gets an inbound lead email. They forward it to [email protected]. The agent looks up the prospect in CRM, pulls recent activity, checks competitive notes, and replies with a one-page briefing — attached as a file. The rep replies: "What about their renewal timeline?" The agent remembers context and answers.
"The Contract Reviewer"
Legal team gets a 40-page vendor contract. They forward it to [email protected]. The agent reads the entire PDF attachment, flags non-standard clauses, summarizes key terms, and replies with a structured risk assessment. Reply back: "What about the indemnification clause specifically?" — it already has the full document in context.
"The CC'd Expert"
A customer emails your support team with a complex technical question. The support rep CCs [email protected]. The agent searches internal docs and past tickets, then reply-alls with a thorough answer. The customer sees a fast, knowledgeable response. The rep looks like a hero.
"The Executive Briefing Bot"
Every morning, a VP emails [email protected] with "What happened yesterday?" The agent uses its tools to pull key metrics, open tickets, and recent activity, then replies with a morning briefing. The VP replies: "Tell me more about that support spike" — and the conversation continues naturally.
"The Always-On Intake Agent"
A consulting firm creates [email protected] for new client inquiries. Prospects email describing their needs. The agent asks qualifying questions, gathers requirements, and the threaded conversation builds a complete intake document — all before a human ever touches it.