# AI Bots Overview

The **My Bots** page (`/ai-bots`) is where administrators create and manage AI assistants that automatically support customers across connected messaging channels.

:::note[Required permission]
You need the **`ai:manage`** or **`workspace:manage`** permission to access **My Bots** and individual bot detail pages. Currently, creating, toggling, editing, deleting bots, and assigning channels inline from the table require **`workspace:manage`**.
:::

## My Bots List

From the left navigation sidebar, go to **Build → My Bots** to view all bots in your workspace.

The list view supports:

- **Search**: Filter bots by name or description.
- **Filters**: Filter by **Status** (Active / Paused), **Reply mode** (Auto-send / Draft suggestion), and **Connected channels** (Has channels / No channels).
- **Columns & sorting**: Customize visible columns and sort by bot name, description, connected channel count, reply mode, or added date.
- **Inline row actions**: Toggle a bot Active/Paused, attach or detach channels directly in the **Channels** column, or open the **`⋮`** menu to view details, pause/activate, edit details, or delete the bot.

## Create a New AI Bot

1. Click **Create new Bot** in the top-right corner of **My Bots**.
2. Choose a bot avatar from the built-in presets or upload a custom image (up to **8 MB**).
3. Enter a **Bot Name** (required, unique within the workspace) and an optional **Description**.
4. Click **Create new Bot**.

Newly created bots start in **Active** status with **Draft suggestion (`DRAFT`)** as the default reply mode and open directly into the bot detail view. The first bot created in a workspace is automatically marked as the default bot.

## Bot Detail Workspace

When you open a bot (`/ai-bots/{botId}`), the left rail includes a bot switcher (to switch between bots or create a new one) and 5 main sections:

| Group | Section | Purpose |
| --- | --- | --- |
| **Training** | [Guidance](/ai-bots/guidance/) | Define communication style, clarification rules, restrictions, and spam handling. |
| **Training** | **Knowledge Base** | Attach 1 knowledge base collection for the bot to reference when answering customers (at most 1 collection per bot at a time). |
| **Training** | [Testing](/ai-bots/testing-and-gaps/) | Simulate chats with the bot, inspect retrieved sources, and fill knowledge gaps. |
| **General** | [Channels](/ai-bots/channel-deployment/) | Connect or disconnect messaging accounts/channels powered by this bot. |
| **General** | [Settings](/ai-bots/configuration/) | Configure sending mode, AI model, response delay, schedule, human handoff, and anti-spam safeguards. |

:::tip[Recommended setup flow]
After creating a bot, add [Guidance](/ai-bots/guidance/) rules, attach a **Knowledge Base**, verify replies under [Testing](/ai-bots/testing-and-gaps/), tune [Bot Configuration](/ai-bots/configuration/), and finally [deploy to your channels](/ai-bots/channel-deployment/).
:::