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

# AI Agents

> Create AI agents that handle conversations, follow your instructions, and hand off to your team.

## What is this?

AI Agents (beta) lets you create AI-powered agents that automatically handle conversations on your connected channels — answering questions from knowledge sources, taking actions like updating contacts or handing off to a human, and following the instructions and guardrails you define, without needing a manual automation flow for every scenario.

![The AI Agents list page showing the Total/Active/Inactive stat tiles, Agentic Mode toggle, and the agents table](https://mintcdn.com/wabis/WS9kn1_MGeoTtoMA/images/ai-agents-list.png?fit=max\&auto=format\&n=WS9kn1_MGeoTtoMA\&q=85\&s=8aa98e649805f4397a3824bb1a013870)

## What can I do here?

* See all AI agents for the active channel with **Total Agents**, **Active Agents**, and **Inactive** stat tiles you can click to filter.
* Search agents by name or description, and filter by type (**Support**, **Sales**, **FAQ**, **Booking**, **Custom**).
* Toggle **Agentic Mode** on or off for the channel from the top toolbar. This is the channel's master switch: when it's off, no agent answers incoming messages, even if the agent itself is **Active**.
* Create a new agent (subject to your plan's agent limit, shown as a counter on the Create button).
* For each agent in the table: **Edit**, **Test** (opens the agent builder), **Export** (downloads the agent as a JSON file), **Activate/Pause**, **Activity**, and **Delete**.
* **Activity** — opens a three-tab dialog (Overview, Conversations, Tools) showing which skills and capabilities that agent used, how often, and in which conversations. See [Activity](https://wabis.mintlify.site/workspace/ai-agents/activity.md).
* Select multiple agents to bulk-select and delete.
* **Import** an agent from a previously exported JSON file into any channel you choose.
* Refresh the agent list.

## How to use it

> [!TIP]
>
> New to AI agents? Follow [Create Your First AI Agent](https://wabis.mintlify.site/workspace/ai-agents/create-your-first-agent.md) — a step-by-step guide with a full example. Come back here afterward for the full detail on any one tab.

1. Go to **AI Agents** in the sidebar (`/ai-agents`). You need an active channel connected to WhatsApp, Instagram, Facebook, or Web Chat.
2. Click **Create** to start a new agent (or **Edit**/**Test** on an existing row to open the same builder). The builder has one tab for each area of the agent.

![The AI agent builder page showing the full row of tabs across the top](https://mintcdn.com/wabis/WS9kn1_MGeoTtoMA/images/ai-agent-detail-tabs.png?fit=max\&auto=format\&n=WS9kn1_MGeoTtoMA\&q=85\&s=ceb693871fd8c23ae897e5204ab926bc)

### Every tab, in its own page

Save the agent first — the Capabilities, External Capabilities, Skills, and Workflows tabs only unlock once the agent has been created.

| Tab | What it's for |
| - | - |
| [General](https://wabis.mintlify.site/workspace/ai-agents/tabs/general.md) | Name the agent and describe its job |
| [Behavior](https://wabis.mintlify.site/workspace/ai-agents/tabs/behavior.md) | Tone, priority, and status |
| [Instructions](https://wabis.mintlify.site/workspace/ai-agents/tabs/instructions.md) | How it should think and act |
| [Knowledge](https://wabis.mintlify.site/workspace/ai-agents/tabs/knowledge.md) | Facts it can look things up in |
| [Capabilities](https://wabis.mintlify.site/workspace/ai-agents/tabs/capabilities.md) | Real actions it can take, including triggering automations |
| [External Capabilities](https://wabis.mintlify.site/workspace/ai-agents/tabs/external-capabilities.md) | Your own APIs or MCP tools |
| [Skills](https://wabis.mintlify.site/workspace/ai-agents/tabs/skills.md) | A specific procedure for one situation |
| [Workflows](https://wabis.mintlify.site/workspace/ai-agents/tabs/workflows.md) | Scripted, multi-step flows bound to this agent |
| [Channels](https://wabis.mintlify.site/workspace/ai-agents/tabs/channels.md) | Where it runs and how it talks |
| [Guardrails](https://wabis.mintlify.site/workspace/ai-agents/tabs/guardrails.md) | Safety checks |
| [Test](https://wabis.mintlify.site/workspace/ai-agents/tabs/test.md) | Try it before customers do |

See the full [Builder Tabs](https://wabis.mintlify.site/workspace/ai-agents/tabs/overview.md) section for all eleven, with worked examples.

### Export and import an agent

Back on the list page, use **Export** to download an agent's configuration as JSON, and **Import** to bring that JSON into another channel — this creates brand-new agent, source, and knowledge records rather than overwriting anything.

### Working with more than one agent

When a channel has two or more active agents, the platform automatically adds a hidden router that reads each customer message and hands it to the agent whose [Description](https://wabis.mintlify.site/workspace/ai-agents/tabs/general.md) fits best — clear, different descriptions per agent are what make this accurate. Priority (set in [Behavior](https://wabis.mintlify.site/workspace/ai-agents/tabs/behavior.md)) decides who goes first when more than one could plausibly answer.

## Troubleshooting / Technical Notes

* **The agent doesn't reply at all.** Check the three master switches: the agent's **Status** is Active, **Agentic Mode** is on for the channel, and the agent's **Channels** tab includes the channel the message came from.
* **I can't create another agent.** Your plan limits how many agents you can create — the limit shows on the **Create** button.
* **A customer is stuck with the agent.** Any teammate can take over the conversation in the Inbox, and you can **Pause** the agent from the list at any time.
* **Activity shows no data.** The agent needs to have run in real conversations within the selected time range. Playground sessions are not included in Activity.

## In this section

* [Create Your First AI Agent](https://wabis.mintlify.site/workspace/ai-agents/create-your-first-agent.md)
* [Builder Tabs](https://wabis.mintlify.site/workspace/ai-agents/tabs/overview.md)
* [Activity](https://wabis.mintlify.site/workspace/ai-agents/activity.md)

## Related docs

* [Automation Overview](https://wabis.mintlify.site/workspace/automation/overview.md)
* [Inbox](https://wabis.mintlify.site/workspace/inbox/overview.md)
* [Analytics](https://wabis.mintlify.site/workspace/analytics.md) — AI Usage tab


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