> 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/panduan-menulis-ai-behavior-and-knowledge-base.md).

# Panduan Menulis AI Behavior & Knowledge Base

Panduan praktis menulis AI Behavior dan Knowledge Base yang rapi, akurat, dan mudah dipahami AI Agent Cekat.

Kualitas jawaban AI Agent paling banyak ditentukan oleh dua hal: **apa yang Anda instruksikan** (AI Behavior) dan **apa yang AI ketahui** (Knowledge Base). Panduan ini menjelaskan cara kerja keduanya dan format penulisan terbaik untuk masing-masing.

{% hint style="info" %}
Panduan ini mengikuti **Tampilan Baru AI Agent** (tab AI Behavior, AI Actions & Routing, AI Configuration, Knowledge Base). Jika Anda masih memakai tampilan lama, lihat bagian [Jika Masih Memakai Tampilan Lama](#jika-masih-memakai-tampilan-lama).
{% endhint %}

## 1. Pahami Peran Setiap Bagian

Kesalahan paling umum adalah menaruh semua hal di satu tempat. Setiap bagian punya fungsi berbeda:

| Bagian                      | Fungsinya                                                                 | Isi yang tepat                                              | Jangan diisi dengan                     |
| --------------------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------- | --------------------------------------- |
| **Welcome Message**         | Sapaan pertama, dikirim **persis seperti yang ditulis** (tidak diolah AI) | Salam, perkenalan singkat, 2–4 pilihan topik                | Instruksi untuk AI                      |
| **Communication Style**     | Kepribadian dan cara bicara                                               | Identitas, nada, bahasa, sapaan, panjang jawaban            | Info produk, harga, SOP                 |
| **Conversation Flow**       | Apa yang dilakukan AI di situasi tertentu                                 | Langkah per skenario: bertanya, menawarkan, order, komplain | Daftar FAQ panjang                      |
| **Rules & Restriction**     | Batasan yang harus dipatuhi AI di setiap balasan                          | Larangan, batas topik, aturan privasi & kepatuhan           | Gaya bahasa, alur percakapan            |
| **Additional Instructions** | Instruksi tambahan, bisa khusus pipeline tertentu                         | Perlakuan berbeda untuk lead baru, pelanggan lama, dsb.     | Instruksi umum yang berlaku untuk semua |
| **AI Actions & Routing**    | Tindakan sistem: transfer ke agen, label, pindah pipeline                 | Kondisi pemicu (Prompt, Keywords, Number Of Message)        | —                                       |
| **Knowledge Base**          | Sumber fakta                                                              | Produk, harga, jadwal, kebijakan, FAQ, SOP                  | Instruksi perilaku                      |

{% hint style="warning" %}
**Knowledge Base diperlakukan sebagai informasi, bukan instruksi.** Jika AI Behavior dan Knowledge Base bertentangan, AI diminta mengikuti AI Behavior lebih dulu. Kalimat seperti "Jangan pernah memberi diskon" yang hanya ditulis di Knowledge Base lemah dan bisa diabaikan. Tulis aturan seperti itu di **Rules & Restriction**.
{% endhint %}

### Cara AI memakai keduanya

1. **Setiap balasan** menyertakan AI Behavior Anda. Communication Style, Conversation Flow, dan Rules & Restriction selalu dikirim, dengan urutan tersebut, diikuti Additional Instructions yang berlaku untuk percakapan itu. Sebuah Additional Instruction berlaku jika tidak memilih pipeline, atau jika percakapan sedang berada di salah satu pipeline yang dipilih. Instruksi dengan judul atau isi kosong dilewati. Welcome Message tidak termasuk di sini: pesan itu dikirim ke pelanggan sebagai pesan tersendiri.
2. Untuk menjawab pertanyaan, AI mencari di Knowledge Base berdasarkan **makna** (bukan kata kunci persis) memakai pesan terakhir pelanggan dan percakapan terbaru, lalu mengambil hanya **potongan yang paling relevan** (konten Text, QnA, File, dan Website bersaing dalam pencarian yang sama). Jumlah maksimum potongan diatur oleh **AI Context Limit** di AI Configuration (50 jika kosong, tidak pernah lebih dari 60). Jika ditemukan lebih dari 20 potongan, sistem mengurutkan ulang dan hanya menyimpan sekitar 20 yang terbaik. Praktisnya, AI melihat sekitar 20 potongan per pertanyaan, sebesar apa pun Knowledge Base Anda.
3. AI juga membaca riwayat percakapan sebanyak **AI History Limit** (default 20 pesan, minimum 10).

Konsekuensinya:

* **Behavior harus ringkas.** Semakin panjang dan bertele-tele, semakin besar kemungkinan instruksi penting terlewat.
* **Knowledge harus terpotong rapi per topik.** AI tidak membaca seluruh Knowledge Base, hanya potongan yang relevan. Setiap potongan harus bisa dipahami tanpa membaca bagian lain.
* **Alur panjang (misalnya order) harus dipecah per langkah**, karena pesan lama bisa keluar dari jendela riwayat.

### Jika instruksi saling bertentangan

* **AI Behavior vs. Knowledge Base:** AI diminta mengikuti AI Behavior lebih dulu, lalu contoh jawaban, baru Knowledge Base.
* **Antar field AI Behavior:** tidak ada field yang otomatis menang. Rules & Restriction **tidak** otomatis mengalahkan Conversation Flow hanya karena bernama "aturan". AI membacanya sebagai satu blok, dengan urutan Communication Style, Conversation Flow, Rules & Restriction, Additional Instructions, lalu memutuskan mana yang dipakai.
* Karena itu, **jangan biarkan konflik terjadi begitu saja.** Jika satu instruksi harus mengalahkan yang lain, tulis dengan kalimat yang jelas, misalnya: "Aturan ini mengalahkan semua langkah di Conversation Flow." (Lihat aturan darurat di [contoh Kesehatan](https://docs.cekat.ai/ai-and-platform/ai-agent/panduan-menulis-ai-behavior-and-knowledge-base/contoh-kesehatan.md).)

## 2. Format Penulisan AI Behavior

### Prinsip umum

1. **Satu instruksi, satu kalimat.** Gunakan bullet, bukan paragraf panjang.
2. **Gunakan kata kerja perintah yang tegas:** "Tanyakan…", "Jawab…", "Jangan…", "Selalu…".
3. **Tulis kondisi secara eksplisit:** "Jika pelanggan menanyakan harga, …". Hindari "kadang-kadang" atau "sebisa mungkin".
4. **Berikan contoh kalimat** untuk respons yang wajib konsisten (format order, kalimat sebelum handoff).
5. **Hindari instruksi yang saling bertentangan** antar field. Misalnya, Communication Style meminta "jawab singkat" tetapi Conversation Flow meminta "jelaskan detail semua manfaat". Jika memang ada pengecualian, tulis secara eksplisit (lihat [Jika instruksi saling bertentangan](#jika-instruksi-saling-bertentangan)).
6. **Jangan menyalin fakta** (harga, stok, alamat) ke Behavior jika sudah ada di Knowledge Base. Dua sumber yang berbeda membuat AI bingung saat salah satunya diperbarui.
7. Gunakan placeholder `[...]` hanya di template, lalu **ganti semuanya** sebelum disimpan.

### Communication Style (maks. 5.000 karakter)

Struktur yang disarankan:

```plaintext
## Identitas
- Kamu adalah [Nama AI], [peran] dari [Nama Bisnis], [deskripsi bisnis 1 kalimat].
- Sebut dirimu "[Nama AI]". Jangan memakai "aku" atau "saya".

## Nada & Sapaan
- Nada: [ramah / profesional / empatik], [semi-formal].
- Sapa pelanggan dengan "Kak" (atau "Bapak/Ibu" jika pelanggan memakai bahasa formal).
- Gunakan emoji secukupnya, maksimal 1 per balasan.

## Bahasa
- Balas dengan bahasa yang dipakai pelanggan (Indonesia, Inggris, Jawa, dll.).

## Format Balasan
- Maksimal 3–4 kalimat per bubble. Pecah info panjang menjadi poin.
- Jangan memakai tabel atau heading markdown di chat.
- Ajukan maksimal 1 pertanyaan per balasan.
- Akhiri balasan dengan pertanyaan lanjutan yang relevan, kecuali percakapan sudah selesai.
```

### Conversation Flow (maks. 8.000 karakter)

Tulis sebagai **daftar skenario**. Setiap skenario berisi pemicu dan langkah bernomor.

```plaintext
## [Nama Skenario]
Pemicu: [kapan skenario ini berlaku]
1. [Langkah pertama]
2. [Langkah berikutnya]
3. [Hasil akhir / kalimat penutup]
```

Skenario minimal yang sebaiknya ada:

| Skenario                                  | Contoh isi                                                    |
| ----------------------------------------- | ------------------------------------------------------------- |
| Pembuka / kualifikasi                     | Tanyakan nama dan kebutuhan, satu per satu                    |
| Pertanyaan informasi                      | Jawab dari Knowledge Base, lalu arahkan ke langkah berikutnya |
| Rekomendasi / penawaran                   | Tanyakan kebutuhan, beri 1–3 pilihan, sebutkan manfaat        |
| Transaksi (order / booking / pendaftaran) | Kirim format data, cek kelengkapan, konfirmasi ringkasan      |
| Keberatan / ragu                          | Akui keberatan, beri 1 alasan kuat atau promo yang berlaku    |
| Komplain                                  | Minta maaf, kumpulkan data, sampaikan bahwa tim akan membantu |
| Info tidak tersedia                       | Jangan menebak; sampaikan akan dicek tim                      |

{% hint style="info" %}
**Kalkulasi harga:** Jika AI perlu menghitung total (ongkir, biaya COD, cicilan), tulis rumusnya sebagai langkah dan minta AI menampilkan rincian per item sebelum total. Atur **AI Creativity Level** ke **Consistent**, dan gunakan model **Advanced** atau **Auto** untuk perhitungan.
{% endhint %}

### Rules & Restriction (maks. 3.000 karakter)

Ini adalah batasan keras. Tulis pendek, tegas, dan urutkan dari yang paling penting.

```plaintext
## Wajib
- Jawab HANYA berdasarkan Knowledge Base dan instruksi ini.
- Jika informasi tidak ada, katakan akan dicek oleh tim. Jangan menebak atau mengarang.

## Dilarang
- Jangan memberikan harga, promo, atau jadwal yang tidak tercantum di Knowledge Base.
- Jangan meminta password, PIN, OTP, atau nomor kartu lengkap.
- Jangan membahas atau merekomendasikan kompetitor.
- Jangan menjawab topik di luar [lingkup bisnis]. Arahkan kembali dengan sopan.
```

### Additional Instructions (maks. 30 instruksi, 2.000 karakter per instruksi)

Gunakan untuk perilaku yang **berbeda per tahap pelanggan** dengan memilih **Pipeline**. Instruksi hanya berlaku selama percakapan berada di pipeline yang dipilih. Tanpa pipeline, instruksi berlaku untuk semua percakapan.

Contoh pemakaian:

* Pipeline **Leads Baru**: fokus kualifikasi dan edukasi.
* Pipeline **Menunggu Pembayaran**: ingatkan batas waktu dan cara bayar.
* Pipeline **Pelanggan Lama**: sapa sebagai pelanggan setia, tawarkan program repeat order.

Setiap instruksi ditampilkan ke AI sebagai "judul: isi", jadi **judulnya ikut dibaca AI**. Beri judul yang jelas (maks. 100 karakter), misalnya "Pipeline Menunggu Pembayaran – Reminder". Judul dan isi harus sama-sama terisi, jika tidak instruksi dilewati.

### Memecah balasan menjadi beberapa bubble (`###`)

Agar jawaban terkirim sebagai beberapa pesan chat, taruh pemisah di barisnya sendiri di antara bagian-bagiannya. Di editor, klik tombol bubble, atau ketik `###` sendirian dalam satu baris.

* Berfungsi di **semua** field AI Behavior (Welcome Message, Communication Style, Conversation Flow, Rules & Restriction, Additional Instructions) dan di **Knowledge Text** serta contoh jawaban.
* Di Behavior dan Knowledge, ini adalah instruksi untuk AI: di mana pun menemukan pemisah, AI mempertahankannya di balasan, lalu sistem mengirim tiap bagian sebagai pesan terpisah.
* Di **Welcome Message**, pemisah memecah sapaan menjadi beberapa pesan di kanal chat. Di widget live chat website, sapaan tampil sebagai satu pesan.
* Hanya baris yang berisi **`###` saja** yang menjadi pemisah. `### Judul` yang diikuti teks adalah heading biasa.
* Hindari menulis `###` di tengah kalimat. Setiap `###` di balasan akhir AI akan memecah pesan.

### Hubungan dengan AI Actions & Routing

Transfer ke agen manusia, pemberian label, dan perpindahan pipeline diatur di **AI Actions & Routing**, bukan di Behavior.

* Di **Behavior**, cukup atur **apa yang dikatakan AI** sebelum atau saat handoff. Contoh: "Sampaikan bahwa admin akan segera membantu."
* Di **AI Actions & Routing**, atur **kapan** tindakan terjadi:
  * **Keywords** untuk permintaan jelas, misalnya "admin", "refund", "komplain".
  * **Prompt** untuk kondisi yang butuh konteks, misalnya "pelanggan sudah mengirim data order lengkap dan mengonfirmasi pesanan".
  * **Number Of Message** sebagai pengaman agar percakapan yang terlalu panjang tetap sampai ke manusia.
* Agent Transfer hanya mengizinkan satu kondisi per jenis pemicu (Prompt, Keywords, Number Of Message), jadi maksimal 3 kondisi.
* Untuk handoff ke tim/divisi tertentu, lihat [Handoff ke Tim/Divisi Tertentu via Prompt](https://docs.cekat.ai/ai-and-platform/ai-agent/ai-agent-behavior/handoff-ke-tim-divisi-tertentu-via-prompt.md).

## 3. Format Penulisan Knowledge Base

### Cara Knowledge Base dibaca

Saat Anda menyimpan, setiap sumber dipotong menjadi beberapa bagian dan disimpan untuk pencarian. Saat ada pertanyaan, AI hanya mengambil potongan yang maknanya paling dekat dengan pesan pelanggan (lihat [Cara AI memakai keduanya](#cara-ai-memakai-keduanya)).

* **Text:** potongan berukuran sekitar 1.000 karakter, dengan sedikit tumpang tindih antar potongan. Pemotongan dilakukan di baris kosong terlebih dahulu, lalu pergantian baris, lalu spasi. **Judul (heading) tidak dipakai sebagai titik potong**, sehingga judul bisa terpisah dari isi di bawahnya.
* **Judul tab:** setiap tab Text disimpan terpisah, dan judul tabnya ditambahkan di bagian atas setiap potongan dari tab itu. Beri nama tab yang jelas dan spesifik.
* **Pencarian berdasarkan makna:** potongan dicocokkan dengan pesan pelanggan berdasarkan kemiripan makna. Pakailah kata-kata yang dipakai pelanggan Anda.

### Pilih sumber yang tepat

| Jenis       | Paling cocok untuk                                 | Catatan                                                                                                                                                                             |
| ----------- | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Text**    | SOP, kebijakan, profil bisnis, info umum           | Paling fleksibel; gunakan tab per topik                                                                                                                                             |
| **QnA**     | Pertanyaan yang sering diulang dengan jawaban baku | Satu pertanyaan, satu jawaban. Setiap pasangan disimpan sebagai satu entri, dan AI menemukannya lewat kemiripan dengan pesan pelanggan, bukan kecocokan persis                      |
| **Product** | Katalog, harga, berat, varian                      | Kelola data di fitur Product agar ada satu sumber kebenaran                                                                                                                         |
| **Website** | Konten yang sudah ada di website                   | Latih ulang setelah website diperbarui                                                                                                                                              |
| **File**    | Dokumen yang sudah ada                             | **Hanya PDF**, dan teksnya harus bisa diseleksi (bisa di-highlight). Gambar dan hasil scan tidak dibaca. Pergantian baris diratakan, jadi gunakan Text untuk tabel dan daftar harga |

### Aturan menulis Knowledge Text

1. **Satu tab = satu topik.** Contoh tab: `Profil & Kontak`, `Produk & Harga`, `Pengiriman & Pembayaran`, `Kebijakan Retur`, `Promo Aktif`, `FAQ`.
2. **Pisahkan setiap item dengan baris kosong dan buat tiap item singkat** (jauh di bawah sekitar 1.000 karakter). Judul dan subjudul membantu Anda dan tim membaca teks, tetapi AI bisa menerima potongan tanpa judulnya, jadi jangan mengandalkan judul saja untuk menjelaskan sebuah baris.
3. **Setiap potongan harus berdiri sendiri.** Sebut nama produk/layanan secara lengkap di setiap baris, jangan pakai kata ganti.
   * ❌ `Harganya Rp250.000 dan tersedia 3 warna.`
   * ✅ `Harga Sepatu Lari AeroRun: Rp250.000. Warna AeroRun: hitam, putih, navy.`
4. **Gunakan format kunci–nilai** untuk data, bukan paragraf, dan ulangi nama item di setiap baris.

   ```plaintext
   ### Paket Belajar Intensif SMA
   - Harga Paket Belajar Intensif SMA: Rp1.200.000/bulan
   - Jadwal Paket Belajar Intensif SMA: Senin, Rabu, Jumat, 16.00–18.00
   - Kapasitas Paket Belajar Intensif SMA: maks. 8 siswa per kelas
   ```
5. **Hindari tabel lebar.** Jika potongan informasi terpisah dari header tabelnya, AI bisa salah membaca kolom. Ubah tabel menjadi daftar per item.
6. **Tulis sinonim dan istilah pelanggan.** Contoh: `Ongkos kirim (ongkir)`, `Uang muka (DP)`, `Cicilan / kredit / angsuran`.
7. **Cantumkan masa berlaku** untuk promo dan harga sementara: `Promo berlaku 1–31 Oktober 2026`. Hapus promo yang sudah berakhir.
8. **Jangan ada informasi yang bertentangan** antar tab atau antar sumber (Text vs Product vs Website).
9. **Untuk mengirim media**, tulis URL beserta kapan harus dikirim:

   ```plaintext
   Kirim gambar panduan ukuran berikut jika pelanggan menanyakan ukuran atau size chart:
   https://contoh.com/size-chart.jpg
   ```
10. **Pecah balasan menjadi beberapa bubble** dengan `###` **di barisnya sendiri** di antara bagian-bagiannya jika jawaban perlu dikirim bertahap (lihat "Memecah balasan menjadi beberapa bubble" di bagian 2).

### Aturan menulis QnA

* Tulis pertanyaan seperti cara pelanggan bertanya, bukan bahasa internal. Teks pertanyaan ikut dicari oleh AI, jadi pertanyaan yang mirip dengan pesan pelanggan lebih mudah ditemukan.
* Jawaban cukup 1–3 kalimat dan lengkap tanpa perlu konteks lain. Entri yang panjang (lebih dari sekitar 1.000 karakter) dipotong menjadi beberapa bagian, dan bagian berikutnya kehilangan pertanyaannya.
* Buat entri terpisah untuk pertanyaan yang berbeda maksud, meskipun mirip.

## 4. Pengaturan Pendukung (AI Configuration)

| Pengaturan              | Rekomendasi                                                                                                                                                                                                                                                                                                                                            |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **AI Model**            | **Auto** jika ragu. **Advanced** untuk perhitungan, analisis gambar, dan tools                                                                                                                                                                                                                                                                         |
| **AI Creativity Level** | **Consistent** untuk harga, kebijakan, kesehatan, dan keuangan. **Balanced** untuk sales umum                                                                                                                                                                                                                                                          |
| **Message Await**       | 10–15 detik jika pelanggan sering mengirim banyak pesan pendek beruntun                                                                                                                                                                                                                                                                                |
| **AI History Limit**    | Naikkan jika alur pemesanan/pendaftaran Anda panjang                                                                                                                                                                                                                                                                                                   |
| **AI Context Limit**    | Mengatur berapa banyak potongan Knowledge Base yang dicari per pertanyaan (default 50, yang dipakai maksimal 60). Hanya sekitar 20 potongan terbaik yang sampai ke AI, jadi jika AI masih melewatkan informasi, perbaiki cara penulisan Knowledge Base, jangan hanya menaikkan angka ini. Jangan diisi 0: tidak ada konten Knowledge Base yang diambil |

## 5. Uji Sebelum Disimpan

1. Siapkan **10–20 pertanyaan uji** dari chat pelanggan asli: harga, promo, komplain, pertanyaan di luar topik, dan pertanyaan yang jawabannya tidak ada di Knowledge Base.
2. Uji di panel **Preview**. Preview memakai pengaturan terbaru, termasuk yang belum disimpan.
3. Untuk menguji Additional Instructions, pilih **pipeline** di Preview.
4. Periksa apakah AI: menjawab sesuai Knowledge Base, tidak mengarang, memakai gaya bahasa yang benar, dan memicu handoff/label dengan tepat.
5. Klik **Save**. Jika hasilnya memburuk, kembalikan lewat **Version History**.

{% hint style="success" %}
**Checklist cepat sebelum Save**

* [ ] Tidak ada placeholder `[...]` yang tertinggal
* [ ] Tidak ada fakta yang ditulis di dua tempat berbeda
* [ ] Tidak ada aturan perilaku di Knowledge Base
* [ ] Tidak ada dua instruksi yang saling bertentangan (atau pengecualiannya ditulis eksplisit)
* [ ] Semua promo memiliki masa berlaku
* [ ] Setiap field berada di bawah batas karakter
* [ ] Kondisi handoff diatur di AI Actions & Routing
  {% endhint %}

## 6. Batas Karakter

| Field                                 | Batas                                              |
| ------------------------------------- | -------------------------------------------------- |
| Welcome Message                       | 5.000 karakter                                     |
| Communication Style                   | 5.000 karakter                                     |
| Conversation Flow                     | 8.000 karakter                                     |
| Rules & Restriction                   | 3.000 karakter                                     |
| Additional Instructions               | Judul 100, isi 2.000 karakter (maks. 30 instruksi) |
| Kondisi Prompt (AI Actions & Routing) | 1.000 karakter                                     |

Dashboard menerapkan batas ini saat Anda mengetik. AI Agent yang dimigrasikan dari tampilan lama mungkin sudah memiliki Conversation Flow yang lebih panjang, karena prompt lama yang panjang dibawa apa adanya.

## Jika Masih Memakai Tampilan Lama

Di tampilan lama, semua instruksi berada di satu field **AI Agent Behavior**. Gunakan urutan yang sama agar mudah dimigrasikan nanti:

```plaintext
### Identitas & Gaya Komunikasi
(isi seperti Communication Style)

### Aturan
(isi seperti Rules & Restriction)

### Alur Percakapan
(isi seperti Conversation Flow)
```

Saat migrasi ke tampilan baru, salin setiap bagian ke field yang sesuai. Lihat [Migrasi ke AI Agent Baru](https://docs.cekat.ai/ai-and-platform/ai-agent/tampilan-baru-ai-agent/migrasi-ke-ai-agent-baru.md).

## Contoh per Industri

* [Retail & E-commerce](https://docs.cekat.ai/ai-and-platform/ai-agent/panduan-menulis-ai-behavior-and-knowledge-base/contoh-retail-and-e-commerce.md)
* [Layanan Keuangan](https://docs.cekat.ai/ai-and-platform/ai-agent/panduan-menulis-ai-behavior-and-knowledge-base/contoh-layanan-keuangan.md)
* [Pendidikan](https://docs.cekat.ai/ai-and-platform/ai-agent/panduan-menulis-ai-behavior-and-knowledge-base/contoh-pendidikan.md)
* [Properti](https://docs.cekat.ai/ai-and-platform/ai-agent/panduan-menulis-ai-behavior-and-knowledge-base/contoh-properti.md)
* [Kesehatan](https://docs.cekat.ai/ai-and-platform/ai-agent/panduan-menulis-ai-behavior-and-knowledge-base/contoh-kesehatan.md)
