> For the complete documentation index, see [llms.txt](https://docs.cekat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cekat.ai/en/ai-and-platform/ai-agent/new-ai-agent-interface/migrating-to-the-new-ai-agent.md).

# Migrating to the New AI Agent

Move an old AI Agent to the new interface with one click.

If you created an AI Agent before this update, it still uses the old interface (marked **Old** on the AI Agents page). You can move it to the new interface with the **Migrate** button. Cekat moves your settings over automatically with the help of AI.

{% hint style="success" %}
Migration **does not change** your old AI Agent. Cekat creates a **new AI Agent** named *\[agent name] (Migrated)* with the migrated settings, while the old AI Agent stays as it is.
{% endhint %}

## How to migrate

1. Open your old AI Agent.
2. Click **Migrate**.

   ![An old AI Agent with the Migrate button at the top right](https://3748649913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzFvvakHJ5OVubOo4WKlR%2Fuploads%2F8aZLTNsj5tCvUvLrsont%2FM1-old-agent-migrate-button.png?alt=media\&token=c59dc99f-d711-4b2c-8e58-a99b86181025)

   ![The Migrate button](https://3748649913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzFvvakHJ5OVubOo4WKlR%2Fuploads%2F1Z67M0UcivOCxY3vSpma%2FM2-migrate-button-closeup.png?alt=media\&token=70414a29-7dfa-47c6-abe2-73e6f6de5b70)
3. Wait for the migration to finish. The button changes to *Migrating...*, and the process takes about **2 minutes**.

   ![A notification that the migration is in progress](https://3748649913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzFvvakHJ5OVubOo4WKlR%2Fuploads%2Fr93SMwwBfRMFiZkTcBrR%2FM3-migration-in-progress-toast.png?alt=media\&token=36f9ad59-61e0-42a5-8ff6-61f12cf6ad6e)

   ![The button changes to Migrating...](https://3748649913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzFvvakHJ5OVubOo4WKlR%2Fuploads%2FeEwxvq0Pd9UXFNDMl3MQ%2FM4-migrating-button.png?alt=media\&token=0766411a-68e3-4f50-b796-82fb1329b7bc)
4. When it finishes, the button changes to **Migrated**. Click the **Open migrated agent** icon next to it to open the new AI Agent.

   ![The Open migrated agent icon](https://3748649913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzFvvakHJ5OVubOo4WKlR%2Fuploads%2FqX8TZZLtWGOWnvhzziFc%2FM5-open-migrated-agent-icon.png?alt=media\&token=2a90849e-6a10-4280-9520-fc50570b39cd)
5. Click **Migration Status** next to the AI Agent name to compare the old and new settings.
6. Check each tab, fix anything that needs adjusting, then click **Save**.
7. Test the new AI Agent with [Preview](https://docs.cekat.ai/en/ai-and-platform/ai-agent/new-ai-agent-interface/ai-behavior.md#preview).
8. Once you're confident, connect the new AI Agent to your inbox.

If the migration fails, your old AI Agent is unchanged. Hover over the **Migrate** button to see the explanation, then click it again to retry.

![The tooltip on the Migrate button after a failed migration: Previous migration attempt failed. Click to try again.](https://3748649913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzFvvakHJ5OVubOo4WKlR%2Fuploads%2FAMaXUd4WFB8UgJ8T4ojL%2FM6-migration-failed-tooltip.jpg?alt=media\&token=0d519e30-d31b-40b8-baf5-2e3572bf4c49)

## What gets migrated?

| Old setting                                     | Becomes                                                                                 |
| ----------------------------------------------- | --------------------------------------------------------------------------------------- |
| AI Agent Behavior                               | Communication Style, Conversation Flow, Rules & Restriction (split and tidied up by AI) |
| Welcome Message                                 | Welcome Message                                                                         |
| Agent Transfer Conditions                       | Agent Transfer conditions                                                               |
| Label Conditions                                | One or more Conversation Label conditions                                               |
| Pipeline Conditions                             | One or more Conversation Pipeline conditions                                            |
| Model, transfer, timezone, memory, and response | AI Configuration                                                                        |

**Not migrated:**

* **Additional Instructions** start out empty, because this feature is new.
* **Pending Status Messages** and **Watcher** are not available in the new interface.

{% hint style="info" %}
Because AI splits and tidies up your old prompt, the wording may differ from the original. Always check the result before using it.
{% endhint %}

## Comparing results with Migration Status

The **Migration Status** button appears next to the name of the migrated AI Agent. Click it to see a comparison of **Old** (previous settings) and **New** (migrated result) for each section:

| Section           | What is compared                                                                             |
| ----------------- | -------------------------------------------------------------------------------------------- |
| AI Agent Behavior | The old prompt vs. Communication Style, Conversation Flow, and Rules & Restrictions          |
| Agent Transfer    | The old transfer prompt vs. the new Agent Transfer conditions                                |
| Labels            | The old labels and prompt vs. the new Conversation Label conditions                          |
| Pipeline          | The old pipelines and prompt vs. the new Conversation Pipeline conditions (Current → Target) |

The character count of each field is shown together with its limit, so you can immediately see which parts are too long. The comparison is read-only; make fixes directly in the AI Behavior or AI Actions & Routing tab.

## If content exceeds the character limit

Fields in the new interface have character limits. If your old prompt is long, the migrated result may exceed them. The field shows the message *Maximum X characters exceeded*, and the tab cannot be saved until all fields are within their limits.

**How to fix it:**

1. Open **Migration Status** to see which parts are too long.
2. Trim or tidy up the content of those fields. You can use **Optimize** to help shorten it.
3. Move business information (prices, addresses, product lists) to the **Knowledge Base** if it was previously written in the prompt.
4. Move instructions meant for a specific pipeline to **Additional Instructions**.
5. Click **Save**.

| Field                                     | Limit |
| ----------------------------------------- | ----- |
| Welcome Message                           | 5,000 |
| Communication Style                       | 5,000 |
| Conversation Flow                         | 8,000 |
| Rules & Restriction                       | 3,000 |
| Additional Instructions (per instruction) | 2,000 |
| Prompts in AI Actions & Routing           | 1,000 |
