> ## Documentation Index
> Fetch the complete documentation index at: https://moengage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Merlin AI Agents

> Learn what Merlin AI agents do in MoEngage, when to use the Global Agent or a Custom Agent, and where to find each topic in this section.

You tell a Merlin AI agent what you want in plain English. The agent looks up the campaigns, segments, and analytics it needs, works through the steps, and hands back the finished work: an answer in the task, a campaign draft in the builder, a saved segment, or a file you download.

Agents draft campaigns, build segments, check campaigns before you send them, translate content, and report on performance. An agent works only within your own workspace.

What a task looks like

Choose a request to watch the agent work through it. The figures are illustrative.

Sample requests

<ol aria-live="polite" />

Agents can make mistakes. Verify any figure that drives a decision.

A task runs in the background, so you send the request and return to it later. For how to read the steps above in a real task, refer to [Anatomy of a Task Transcript](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/agents/run-and-manage-agent-tasks.md#anatomy-of-a-task-transcript).

Two families of agent run in the **Merlin AI Agents** hub. Both families use the same hub, task list, transcripts, output files, and workspace memory, so the procedures documented for one family apply to the other.

> [card] [Global Agent](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/agents/global-agent.md)
>
> MoEngage builds and maintains the Global Agent, which requires no configuration before your first task. Use the Global Agent for work that crosses more than one screen, and for work you have not yet turned into a repeatable process.

> [card] [Custom Agents](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/agents/custom-agents.md)
>
> Your team builds a Custom Agent with its own instructions, tools, and schedule. Use a Custom Agent for a task your team repeats.

### Choosing Between the Two

Start from the work rather than the agent. Find the job closest to yours in the following table.

| The work in front of you | Use | Why |
| :- | :- | :- |
| Last week's open rates dropped and you need to know what caused it | Global Agent | You are investigating, and each answer changes your next question |
| You want the size and reachability of an audience before you commit to a campaign | Global Agent | A one-off check you act on straight away |
| You need a campaign draft for a brief that will not come up again | Global Agent | Nothing here is worth saving as a reusable agent |
| Every push campaign must be checked for broken links and locale gaps before it goes out | Custom Agent | The same checks, applied the same way, on every campaign |
| The team must translate campaigns to one agreed house style | Custom Agent | Any teammate runs the same agent and gets the same treatment |
| You want last week's channel performance in your inbox every Monday | Custom Agent | Only a Custom Agent runs on a schedule and emails the result |

The distinction is the same in each case. The Global Agent answers what you are asking now, in your own words. A Custom Agent produces the same kind of output on every run, for whoever runs it.

A job that needs several specialists is still a Custom Agent. Attach them to a coordinator agent. Refer to [Build Multi-Agent Workflows](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/agents/build-multi-agent-workflows.md).

To start your first task, refer to [Merlin AI Agents Home](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/agents/merlin-ai-agents-home.md), which covers reaching the hub and sending a task to either family.

## Pages in This Section

The following pages apply to both agent families:

| Page | What it covers |
| :- | :- |
| [Agent Permissions and Security](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/agents/agent-permissions-and-security.md) | The permission scopes, data privacy protocols, and enterprise security guardrails governing Merlin AI agents within MoEngage. |
| [Merlin AI Agents Home](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/agents/merlin-ai-agents-home.md) | Reaching the hub, starting a task with any agent, and finding, pinning, renaming, sharing, and archiving the tasks in your workspace. |
| [Run and Manage Agent Tasks](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/agents/run-and-manage-agent-tasks.md) | Starting, monitoring, queueing, resuming, and sharing tasks, reading a task transcript, reviewing output files, and understanding agent and workspace memory. |

The following pages cover one agent family each:

| Page | What it covers |
| :- | :- |
| [Global Agent](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/agents/global-agent.md) | What the Global Agent does, which tasks the agent handles, and how the agent differs from a Custom Agent. |
| [Custom Agents](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/agents/custom-agents.md) | Building, configuring, testing, publishing, and managing Custom Agents that automate campaign workflows in your workspace. |
| [Build Multi-Agent Workflows](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/agents/build-multi-agent-workflows.md) | Attaching existing Custom Agents as sub-agents to a coordinator agent, so one task delegates work to specialists and consolidates the output. |

## Connectors

A connector gives an agent access to an application outside MoEngage, so a single run works with your campaign data and that application together.

| Page | What it covers |
| :- | :- |
| [Connect External Apps to Custom Agents](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/connectors/connect-external-apps.md) | Connecting external applications so the Custom Agents you run work with them alongside your MoEngage data. |
| [Figma Connector](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/connectors/figma.md) | Turning Figma frames into MoEngage email templates and reusable design sections into content blocks. |
| [Lokalise Connector](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/connectors/lokalise.md) | Translating your MoEngage content with Lokalise and building the localized campaign from the result. |
| [Smartling Connector](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/connectors/smartling.md) | Running your Smartling translation workflow from content block to campaign in a single agent run. |

## Other Agents and Integrations

| Page | What it covers |
| :- | :- |
| [Campaign Insights Agent](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/campaign-insights-agent.md) | A conversational assistant built into the campaign analytics page, for analyzing performance, diagnosing delivery issues, and receiving recommendations based on your workspace's own data. |
| [MoEngage MCP Server and Connector](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/moengage-mcp-server.md) | Connecting AI assistants such as Claude and ChatGPT to your workspace to build campaigns, manage segments and flows, and analyze performance through natural language. |

## Before You Start

* **Availability.** The Global Agent and Custom Agents are Early Access features. If either family does not appear in your dashboard, contact your Customer Success Manager (CSM). For details, refer to [Feature Enablement](https://moengage.com/docs/user-guide/ai-and-intelligence/merlin-ai/agents/agent-permissions-and-security.md#feature-enablement).
* **Permissions.** An agent acts within your own MoEngage permissions. An agent cannot access data or make changes that you cannot access or make yourself.
* **Campaign publishing.** An agent prepares campaign drafts and does not publish a campaign. You publish the campaign from the standard MoEngage campaign builder.
* **MoEngage Credits.** Every agent run, including scheduled runs and multi-agent workflows, consumes MoEngage Credits from your workspace's monthly balance. For more information, refer to [Merlin AI Usage](https://moengage.com/docs/user-guide/settings/account/billing/merlin-ai-usage.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.