# Manage AI Agents

{% hint style="warning" %}
Managing AI agents requires the **Manage AI agents** permission.
{% endhint %}

To manage AI agents, go to the **AI Agents** dashboard.

All new workspaces begin with a "Default AI Agent" AI, which can be modified or deleted.

***

## Switch AI Agents

The dashboard displays settings for one agent at a time.

To manage a different one:

1. At the top of the AI Agents dashboard, select the **current agent dropdown**.
2. Select the **AI agent** to switch to.

***

## Create or Import an AI Agent

{% hint style="info" %}
The number of AI agent available depends on the subscription plan.
{% endhint %}

1. At the top of the AI Agents dashboard, select the **current AI dropdown**.
2. Select **Create AI Agent**.
3. In the opened menu, choose between **Create** and **Import AI Agent** and continue below.

#### **Create AI Agent**

Set the following options:

* **Avatar** (optional) — the AI's profile pic in messaging apps.
* **Name** — the AI's name in messaging apps. 
* **Default language** — the default localisation language for triggers and actions.

{% hint style="warning" %}
Importing is for legacy chatbots previously exported from Proto v2  (pre-2025).
{% endhint %}

#### **Import AI Agent**

Set the following options:

* **Avatar** (optional) — the AI's profile pic in messaging apps.
* **Name** — the AI's name in messaging apps.
* **Upload file** — upload the ZIP of a previously exported Proto v2 AI.

Press **Create** to finish creating or importing the AI.

***

## Settings

Configure and publish an AI agent across the following categories, each represented by a tab.

### General

In the **General** tab:

* **Avatar** (optional) — the AI's profile pic in messaging apps.
* **Name** — the AI's name in messaging apps.
* **Available languages** — the languages used to localise applicable content in triggers and actions.
* **Default language** — the default localisation language when opening the Actions tab.

{% hint style="warning" %}
The number of assignable languages depends on the subscription plan.
{% endhint %}

***

### External AI Agent Handoff

### Actions

Go to [Actions](/docs/modules/ai-agents/workflows-and-actions.md) for scripted triggers and actions in the agent's chat flow.

***

### LLMs

Go to [LLMs](/docs/modules/ai-agents/workflows-and-actions.md) for adding a third-party, large language model to an agent.

***

### Publish

Go to [Publishing](/docs/modules/ai-agents/publishing.md) for deploying the agent live to messaging channels.

***

## Delete an Agent

1. Go to the **Settings** tab.
2. Select **Delete** and confirm.

Deleting an agent is a permanent action and cannot be undone.

A deleted agent's historic chat logs will persist, but the messaging channels it was published to will be rendered useless (e.g. a WhatsApp thread). Take precautions to migrate your audience to another AI agent's channels in advance.


---

# 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://documentation.proto.cx/docs/modules/ai-agents/manage-ai-agents.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.