# Raven Email AI Agent

* New Email Agent type — a dedicated AI agent built specifically for email, separate from DM and Community agents. Select it when creating a new agent in Raven.
* Works with Gmail, Microsoft Office 365, and any custom SMTP/IMAP email provider (Zoho, Yahoo, iCloud, and more).
* Available 24/7 — the agent handles incoming emails at any time, including outside business hours.
* Understands the full email thread — every reply is based on the complete conversation history, so context is never lost across exchanges.
* 5-step guided setup — Instructions, Resources, Actions, Test, Deploy — with email-specific behavior built in from the start.
* E-commerce ready — connect your Shopify, WooCommerce, Salla, or Zid store so the agent can answer product and order questions directly.
* Multilingual support — the agent understands and replies in multiple languages.
* Edit Mode for live agents — make changes to an active agent and test them before publishing, so your customers are never disrupted.
* Session-based pricing — each email thread counts as one session, with each session priced at 50% of the standard DM Agent rate.

### Before & After

| Before                                                                                                             | After                                                                                                                                                     |
| ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Email inquiries required manual handling by the team — no AI agent existed for email channels.                     | An Email Agent can now be assigned to any email channel, handling incoming emails automatically, 24 hours a day.                                          |
| Emails sat unanswered until business hours, leaving customers waiting.                                             | Customers receive a response at any time of day — no waiting for office hours.                                                                            |
| AI agents were built for chat. They had no understanding of email thread history or professional email formatting. | The Email Agent reads the full email thread before every reply, maintaining context across the entire conversation and responding in proper email format. |
| A generic agent creation flow with no email-specific guidance or configuration.                                    | A dedicated 5-step setup — Instructions, Resources, Actions, Test, Deploy — with email-optimized behavior built in.                                       |
| Changes to a live agent took effect immediately with no way to preview them first.                                 | Use the Edit Mode button on a live agent to make and test changes safely before publishing them.                                                          |
| No product-aware AI for email — product questions had to be handled manually.                                      | Connect your Shopify, WooCommerce, Salla, or Zid store so the agent can answer product and order questions directly from email.                           |
| Standard per-agent rate applied regardless of channel type.                                                        | Each email thread counts as one session, with each session priced at 50% of the standard DM Agent rate.                                                   |

### How to Use It

Setting up your first Email Agent takes just a few minutes:

**Create your agent**

1. Go to Raven in your MyAlice dashboard. Click + Create AI Agent.
2. In the Create New AI Agent modal, select Email Agent from the Agent type dropdown.
3. Enter a name for your agent (e.g., "Support Assistant", "Order Help Desk") and click Create AI Agent. You will land directly on the setup flow.

**Configure the 5 steps**

4. Instructions — Write what your agent will do. Describe its role, the type of questions it handles, and any rules you want it to follow. Click Save Changes when done.
5. Resources — Add knowledge your agent can reference when answering emails. You can add website URLs (auto-scanned or added manually), upload documents, write Q\&A pairs, or sync your product catalog from Shopify, WooCommerce, Salla, or Zid.
6. Actions — Configure what the agent can do beyond replying: assign the conversation to a team member, close a resolved ticket, or trigger an API call to an external system.
7. Test — Use the built-in playground to chat with your agent and see how it responds. Review its reasoning to spot any gaps before going live.
8. Deploy — Assign the agent to your email channel: Gmail, Office 365, or a custom SMTP/IMAP connection. Once deployed, the agent begins handling incoming emails immediately.

**Make changes to a live agent**

9. From the Raven dashboard, click the three-dot menu next to an active agent and select Configure.
10. Click Edit Mode at the top of the page. This lets you update the agent's instructions, resources, or actions without affecting what customers currently see.
11. Test your changes in the playground, then click Publish to make them live.

*Tip: The Resources tab shows a warning when you are editing a live agent's knowledge — any training changes take effect immediately. Use Edit Mode to stage other changes safely before publishing.*

### Where Email Agent Fits

Raven supports three types of AI agents. Here is how they compare:

| Agent Type          | Purpose                                               | Supported Channels                                                      |
| ------------------- | ----------------------------------------------------- | ----------------------------------------------------------------------- |
| **Email Agent**     | Handles customer emails with AI-generated responses   | Gmail, Office 365, Custom SMTP/IMAP                                     |
| **DM Agent**        | Handles private messages with full e-commerce support | WhatsApp, Messenger, Instagram, Telegram, LiveChat, LINE, Viber, WeChat |
| **Community Agent** | Replies to public comments on social platforms        | Facebook, Instagram, YouTube, Play Store, App Store                     |

*Email Agents can only be assigned to email channels. For messaging platforms like WhatsApp or Messenger, use a DM Agent. For social comments on Facebook, Instagram, or YouTube, use a Community Agent.*

### Summary of Benefits

* Automate email support 24/7 — the agent reads full thread history and replies in a professional email format.
* Fast setup in 5 steps — from creation to a live, deployed agent in minutes.
* Safe iteration — Edit Mode and the testing playground mean no surprises for your customers.
* E-commerce and multilingual support built in — no extra configuration needed.
* Cost-effective session-based pricing — each email thread counts as one session, charged at 50% of the standard DM Agent rate.

### Availability

| Detail                        | Information                                                                                                                          |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Feature**                   | Email Agent                                                                                                                          |
| **Availability**              | Globally available to all MyAlice accounts                                                                                           |
| **Supported Email Platforms** | Gmail, Microsoft Office 365, Custom SMTP/IMAP (Zoho, Yahoo, iCloud, and others)                                                      |
| **E-Commerce Integrations**   | Shopify, WooCommerce, Salla, Zid                                                                                                     |
| **Multilingual Support**      | Yes — the agent can understand and reply in multiple languages                                                                       |
| **Pricing**                   | Session-based — each email thread is one session, charged at 50% of the standard DM Agent rate (default; customizable per agreement) |
| **Plan Requirement**          | Available on plans that include AI Agent features                                                                                    |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.myalice.ai/release-log/raven-email-ai-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
