> 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/ai-and-platform/ai-agent/tampilan-baru-ai-agent/migrasi-ke-ai-agent-baru.md).

# Migrasi ke AI Agent Baru

Pindahkan AI Agent lama ke tampilan baru dengan satu klik.

Jika Anda sudah memiliki AI Agent sebelum pembaruan ini, AI Agent tersebut masih menggunakan tampilan lama (ditandai **Old** di halaman AI Agents). Anda dapat memindahkannya ke tampilan baru dengan tombol **Migrate**. Cekat akan memindahkan pengaturan Anda secara otomatis dengan bantuan AI.

{% hint style="success" %}
Migrasi **tidak mengubah** AI Agent lama Anda. Cekat membuat **AI Agent baru** bernama *\[nama agent] (Migrated)* dengan pengaturan yang sudah dipindahkan, sedangkan AI Agent lama tetap ada.
{% endhint %}

## Cara melakukan migrasi

1. Buka AI Agent lama Anda.
2. Klik **Migrate**.

   ![AI Agent lama dengan tombol Migrate di kanan atas](https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2Fq5kI0OQzBlLsK9VivPNw%2FM1-agent-lama-tombol-migrate.png?alt=media\&token=6689b708-0a76-4b56-98c5-0b288d20604f)

   ![Tombol Migrate](https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FlTHeAKmmPgbrJb1Y0f3u%2FM2-tombol-migrate-zoom.png?alt=media\&token=8acc7f92-92ce-4b05-9288-d6d10e1356f2)
3. Tunggu proses migrasi selesai. Tombol berubah menjadi *Migrating...*, dan prosesnya memakan waktu sekitar **2 menit**.

   ![Notifikasi bahwa migrasi sedang berjalan](https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FnFTmQmvUowfFQdsNZnvk%2FM3-migrasi-berjalan-notifikasi.png?alt=media\&token=738d1d76-8d7b-4a67-a398-d7571282de0c)

   ![Tombol berubah menjadi Migrating...](https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FQofWjaoHbVRwBkGKnL9w%2FM4-tombol-migrating.png?alt=media\&token=2f9852c8-5795-4ad5-b6ed-32874a8db147)
4. Setelah selesai, tombol berubah menjadi **Migrated**. Klik ikon **Open migrated agent** di sebelahnya untuk membuka AI Agent baru.

   ![Ikon Open migrated agent](https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FeeOQCjft8Kva6hrn6K8k%2FM5-tombol-open-migrated-agent.png?alt=media\&token=188d7fb8-1266-4775-ae29-da2dc7c61792)

   ![AI Agent hasil migrasi dengan tombol Migration Status](https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2F9muCfl91BlcyO6hWdzoB%2FM6-agent-hasil-migrasi-tombol-migration-status.png?alt=media\&token=348d39a1-fb0a-4424-af4e-866abf52324c)
5. Klik **Migration Status** di samping nama AI Agent untuk membandingkan pengaturan lama dan baru.

   ![Jendela Migration Status membandingkan pengaturan Old dan New](https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FRIie3oYGc8cY6aeuV7kk%2FM7-migration-status-ai-agent-behavior-old-vs-new.png?alt=media\&token=b4825a83-6f29-4e9c-92b5-7938fd109a4a)
6. Periksa setiap tab, perbaiki bagian yang perlu disesuaikan, lalu klik **Save**.
7. Uji AI Agent baru lewat [Preview](https://docs.cekat.ai/ai-and-platform/ai-agent/tampilan-baru-ai-agent/ai-behavior.md#preview).
8. Setelah yakin, pasang AI Agent baru di inbox Anda.

Jika migrasi gagal, AI Agent lama tidak berubah. Arahkan kursor ke tombol **Migrate** untuk melihat keterangan, lalu klik lagi untuk mencoba ulang.

## Apa saja yang dipindahkan?

| Pengaturan lama                                | Menjadi                                                                                    |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------ |
| AI Agent Behavior                              | Communication Style, Conversation Flow, Rules & Restriction (dibagi dan dirapikan oleh AI) |
| Welcome Message                                | Welcome Message                                                                            |
| Agent Transfer Conditions                      | Kondisi Agent Transfer                                                                     |
| Label Conditions                               | Satu atau beberapa kondisi Conversation Label                                              |
| Pipeline Conditions                            | Satu atau beberapa kondisi Conversation Pipeline                                           |
| Model, transfer, timezone, memori, dan respons | AI Configuration                                                                           |

**Tidak ikut dipindahkan:**

* **Additional Instructions** dimulai dalam keadaan kosong, karena fitur ini baru.
* **Pending Status Messages** dan **Watcher** tidak tersedia di tampilan baru.

{% hint style="info" %}
Karena AI membagi dan merapikan prompt lama Anda, susunan kalimatnya bisa berbeda dari aslinya. Selalu periksa hasilnya sebelum digunakan.
{% endhint %}

## Membandingkan hasil dengan Migration Status

Tombol **Migration Status** muncul di samping nama AI Agent hasil migrasi. Klik tombol ini untuk melihat perbandingan **Old** (pengaturan lama) dan **New** (hasil migrasi) untuk setiap bagian:

| Bagian            | Yang dibandingkan                                                                  |
| ----------------- | ---------------------------------------------------------------------------------- |
| AI Agent Behavior | Prompt lama vs. Communication Style, Conversation Flow, dan Rules & Restrictions   |
| Agent Transfer    | Prompt transfer lama vs. kondisi Agent Transfer baru                               |
| Labels            | Label dan prompt lama vs. kondisi Conversation Label baru                          |
| Pipeline          | Pipeline dan prompt lama vs. kondisi Conversation Pipeline baru (Current → Target) |

![Bagian Agent Transfer, Labels, dan Pipeline pada Migration Status](https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2F33NgomOSrOECsKr9uFsv%2FM8-migration-status-bagian-transfer-label-pipeline.png?alt=media\&token=d01a802f-16ac-43f6-b1be-963c745cd467)

![Perbandingan Agent Transfer dan Labels](https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FGip3IKH4bceGOsgF1RFG%2FM9-migration-status-agent-transfer-dan-labels.png?alt=media\&token=04d5a4ec-6e33-4896-89fc-738482bcf72e)

![Perbandingan Pipeline](https://3693109682-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZNZlvyOVkZXyd3pz2Cql%2Fuploads%2FSAK3Fl3qUchFtejV6kLB%2FM10-migration-status-pipeline.png?alt=media\&token=9b1e8a59-fd60-42c6-934c-b7d1156bb1ba)

Jumlah karakter setiap field ditampilkan bersama batasnya, sehingga Anda bisa langsung melihat bagian yang terlalu panjang. Perbandingan ini hanya untuk dibaca; perbaikan dilakukan langsung di tab AI Behavior atau AI Actions & Routing.

## Jika isi melebihi batas karakter

Field di tampilan baru memiliki batas karakter. Jika prompt lama Anda panjang, hasil migrasi bisa melebihi batas. Field tersebut menampilkan pesan *Maximum X characters exceeded*, dan tab tidak bisa disimpan sampai semua field berada dalam batas.

**Cara memperbaikinya:**

1. Buka **Migration Status** untuk melihat bagian yang terlalu panjang.
2. Pangkas atau rapikan isi field tersebut. Anda dapat menggunakan **Optimize** untuk membantu meringkas.
3. Pindahkan informasi bisnis (harga, alamat, daftar produk) ke **Knowledge Base** jika sebelumnya ditulis di prompt.
4. Pindahkan instruksi khusus untuk pipeline tertentu ke **Additional Instructions**.
5. Klik **Save**.

| Field                                   | Batas |
| --------------------------------------- | ----- |
| Welcome Message                         | 5.000 |
| Communication Style                     | 5.000 |
| Conversation Flow                       | 8.000 |
| Rules & Restriction                     | 3.000 |
| Additional Instructions (per instruksi) | 2.000 |
| Prompt di AI Actions & Routing          | 1.000 |
