For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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.

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

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.)

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).

  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:

Conversation Flow (maks. 8.000 karakter)

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

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

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.

Rules & Restriction (maks. 3.000 karakter)

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

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.

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).

  • 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.

  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:

  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.

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:

Saat migrasi ke tampilan baru, salin setiap bagian ke field yang sesuai. Lihat Migrasi ke AI Agent Baru.

Contoh per Industri