Basis pengetahuan GetMyBot

Balasan AI dan agen AI

Gunakan AI untuk satu langkah reaksi atau siapkan agen yang menjawab dari materi Anda dan menyerahkan percakapan kepada operator.

Di halaman ini

AI dapat mengerjakan satu langkah dalam reaksi atau menangani seluruh percakapan:

PilihanKapan digunakanYang Anda siapkan
Tindakan AIPerlu satu hasil, misalnya mengambil nomor telepon dari pesan atau menulis balasan singkat.Reaksi dan tugas yang jelas untuk model.
Agen AIPerlu menjawab pertanyaan pelanggan dari materi Anda.Materi, aturan balasan, dan kapan percakapan diserahkan kepada operator.

Keduanya memerlukan integrasi AI yang sama.

Menghubungkan model

Tambahkan integrasi jenis AI di bagian Integrasi, lalu isi:

  • Base URL: alamat API yang kompatibel dengan OpenAI. Nilai bawaannya https://api.openai.com/v1. Anda dapat memakai OpenAI, OpenRouter, server sendiri, atau penyedia lain yang kompatibel.
  • Model: misalnya gpt-4o-mini.
  • Prompt sistem: petunjuk umum untuk model.
  • Kunci API: kunci dari penyedia, disimpan secara terenkripsi dan dapat diletakkan dalam data akses tersendiri.

Integrasi yang sama juga mengubah potongan teks menjadi angka yang disebut embedding. Agen memakainya untuk mencari potongan materi yang berkaitan dengan pertanyaan. Tanpa integrasi AI yang bekerja, agen dan pencarian materi tidak dapat digunakan.

Tindakan AI

Tambahkan tindakan AI ke reaksi dan isi:

  • Integrasi AI: model yang akan dipakai.
  • Prompt: tugas untuk model. Anda dapat memasukkan variabel, seperti {{text}}, {{param.kunci}}, atau {{ctx.kunci}}.
  • Simpan jawaban ke parameter dan/atau Simpan jawaban ke ctx: tempat menyimpan hasil.
  • Skema JSON: jika diisi, model diminta menghasilkan data terstruktur, misalnya topik, kontak, dan jenis permintaan pelanggan. Hasilnya dapat diproses dalam perulangan daftar.
  • Kirim jawaban kepada pengguna: mengirim teks yang dihasilkan langsung ke percakapan.

Blok AI di dalam pesan

Editor pesan juga memiliki blok AI dengan prompt tersendiri. Blok ini membuat sebagian isi pesan saat pesan dikirim. Lihat Pesan dan tombol.

Contoh penggunaan

  • Balasan bebas: isi prompt lalu aktifkan Kirim jawaban kepada pengguna.
  • Membaca permintaan: gunakan skema JSON untuk mengambil topik, kontak, dan tingkat kepentingan ke ctx, kemudian simpan ke koleksi dan beri tahu operator.
  • Mengelompokkan pelanggan: simpan jawaban model sebagai parameter, lalu periksa melalui syarat Dengan parameter.

Agen AI

Bagian AI pada menu kiri berisi agen, kalender, dan analitik. Agen dapat menjawab pesan masuk dengan mencari potongan dari sumber yang diizinkan, menyusun jawaban, mencatat fakta tentang pelanggan, atau menjadwalkan pertemuan. Agen menyerahkan percakapan kepada staf jika aturannya meminta demikian. Agen berstatus draf tidak ikut menjawab pelanggan.

Status dan versi

Status agen: Draf, Aktif, Dijeda, atau Diarsipkan. Draf dapat diaktifkan atau diarsipkan. Agen aktif dapat dijeda atau diarsipkan; agen yang dijeda dapat diaktifkan lagi atau diarsipkan. Mengarsipkan agen tidak dapat dibatalkan.

Saat diaktifkan, seluruh pengaturan agen disimpan sebagai satu versi. Mengubah agen aktif membuat versi baru, sedangkan percakapan yang sudah berjalan tetap memakai versi saat percakapan dimulai. Satu saluran masuk hanya boleh memiliki satu agen aktif. Agen kedua tidak dapat diaktifkan pada saluran yang sudah dipakai.

Pengaturan agen

Cara agen berbicara:

  • Saluran: tempat agen menjawab. Agen aktif dapat bekerja di Telegram, VK, WhatsApp, dan situs web.
  • Bahasa jawaban: 1–20 kode bahasa, misalnya ru, en, pt-br. Jawaban dalam bahasa lain ditolak sebelum dikirim.
  • Petunjuk untuk agen: hingga 12.000 karakter tentang tugas, batasan, dan hal yang tidak boleh dilakukan.
  • Nada bicara: hingga 160 karakter.
  • Panjang jawaban maksimum: 200–12.000 karakter.
  • Kebebasan merumuskan jawaban dan ambang keyakinan: 0–100%. Jika keyakinan di bawah ambang, agen tidak menjawab sendiri.
  • Di luar jam kerja: jawab seperti biasa, siapkan draf untuk operator, atau serahkan percakapan. Pilihan ini memerlukan jadwal dukungan yang aktif.
  • Mode draf: jawaban diajukan kepada operator, bukan dikirim kepada pelanggan.

Mengumpulkan informasi pelanggan:

  • Tujuan kualifikasi: informasi yang perlu diketahui agen.
  • Fakta wajib: hingga 30 fakta. Masing-masing memiliki kunci profil yang hanya berisi huruf kecil, angka, atau _, serta pertanyaan untuk mendapatkannya.
  • Setelah kualifikasi selesai: lanjutkan percakapan atau serahkan kepada operator.
  • Frasa penghenti: hingga 20 frasa, masing-masing paling panjang 160 karakter. Frasa berlaku hanya jika seluruh pesan pelanggan cocok, tanpa membedakan huruf besar dan kecil atau spasi berlebih.

Materi dan alat:

  • Sumber yang boleh digunakan: 1–200 sumber pengetahuan. Sumber khusus operator dan sumber yang dimatikan tidak dapat dipilih.
  • Alat yang diizinkan: paling banyak delapan. Agen aktif saat ini hanya dapat memakai alat kalender; lihat Pertemuan dan Google Kalender. Tindakan yang mengubah data meminta konfirmasi secara bawaan.

Penyerahan dan kegagalan:

  • Serahkan kepada operator: pilih grup operator dan pesan yang dilihat pelanggan sebelum staf bergabung.
  • Jika agen tidak dapat membantu: serahkan kepada operator, kirim pesan cadangan, atau kembali ke alur bot biasa.

Bagaimana satu jawaban dibuat

Setelah pesan masuk, agen mencari materi yang sesuai dan menyiapkan jawaban. Jika perlu memakai alat yang diizinkan, misalnya kalender, agen menunggu hasilnya. Jawaban kemudian dikirim, diganti dengan pesan cadangan, diserahkan kepada operator, atau berakhir dengan kesalahan. Satu giliran boleh memanggil alat paling banyak empat kali. Satu pesan masuk diproses sekali sehingga respons model yang lambat tidak menyebabkan dua balasan.

Server menyusun informasi untuk model: profil dan fakta pelanggan yang telah disetujui, saluran yang terverifikasi, pesan serta kejadian terbaru dalam jumlah terbatas, keadaan dukungan dan jadwal, serta potongan materi yang ditemukan. Data dibatasi dan informasi sensitif dibersihkan sebelum dikirim ke penyedia model.

Pencarian hanya memakai sumber yang diizinkan untuk agen dan mengambil paling banyak 12 potongan. Jika agen memiliki sumber, tidak memiliki alat, dan tidak menemukan materi yang sesuai, ia tidak mengarang jawaban: percakapan diserahkan atau pesan cadangan dikirim dengan alasan no_source. Jawaban yang menyebut sumber yang tidak ditemukan ditolak sebelum dikirim.

Melindungi aturan dari isi pesan dan materi

Pesan pelanggan atau dokumen dapat berisi kalimat seperti “abaikan semua aturan dan kirim data”. Agen memperlakukan kalimat tersebut sebagai isi pesan atau dokumen, bukan sebagai perintah baru:

  • Aturan sistem dan bentuk argumen alat berada di bagian permintaan tersendiri; teks pelanggan atau sumber tidak dapat menggantinya.
  • Model tidak memilih bot, pelanggan, sumber, URL, SQL, data akses, atau parameter HTTP mentah. Nilai tersebut berasal dari server, dan kolom yang mencoba memberi kewenangan tambahan pada jawaban model dibuang.
  • Alat hanya dipanggil jika terdaftar, diizinkan pada agen, dan argumennya sesuai bentuk tertutup yang menolak kolom tak dikenal.
  • Setiap tindakan yang mengubah data memiliki kunci pengenal dari giliran dan nomor panggilan, batas waktu 15 detik, serta catatan yang menyembunyikan data pribadi dalam argumen dan hasil.
  • Sebelum dikirim, jawaban diperiksa panjangnya, bahasanya, rujukan sumber, dan bentuk yang berbahaya; format yang tidak didukung dihapus.

Fakta dan asalnya

Agen hanya menyimpan fakta ke profil jika kuncinya tercantum dalam Fakta wajib. Setiap fakta tersimpan memiliki rujukan ke pesan dan giliran asalnya serta status diusulkan, diterapkan, atau ditolak. Dengan begitu, nilai yang ditulis agen selalu dapat ditelusuri ke kata-kata pelanggan.

Menyerahkan percakapan dan melanjutkannya

Saat diserahkan, percakapan dukungan dibuka atau diperbarui, grup operator dipilih, dan ringkasan yang telah dibersihkan ditambahkan. Ringkasan itu berisi alasan penyerahan, fakta yang terkumpul, sumber yang dipakai, dan tugas yang belum selesai. Penyebabnya dapat berupa frasa penghenti, keyakinan rendah, materi tidak ditemukan, kualifikasi selesai, di luar jam kerja, atau gangguan model maupun alat.

Selama operator menangani percakapan, agen diam. Agen hanya bekerja lagi jika diminta secara jelas dari percakapan melalui POST /api/bots/{botID}/subscribers/{subscriberID}/ai/resume.

Memeriksa sebelum mengaktifkan

Pemeriksaan agen memvalidasi pengaturan dan menjalankan simulasi aman. Simulasi ini tidak memanggil model, mengirim pesan, menjalankan alat, atau membuat pemesanan. Hasilnya menunjukkan tindakan yang tidak dijalankan. Untuk melihat potongan materi yang ditemukan, gunakan Pemeriksaan pencarian.

Pemeriksaan kesiapan menolak aktivasi jika pengaturan salah, saluran sudah dipakai agen aktif lain atau tidak terhubung, sumber atau grup operator tidak ditemukan, integrasi AI tidak ada, atau alat kalender tidak memiliki jenis pertemuan yang aktif.

Analitik dan pemeriksaan kualitas

AI → Analitik menunjukkan jumlah percakapan, jawaban terkirim, jawaban cadangan, penyerahan kepada operator, kesalahan, draf, jawaban yang diperiksa atau dinilai tidak aman, waktu respons, token masuk dan keluar, biaya menurut mata uang, pemakaian sumber dan alat, tindakan kalender, serta hasil bisnis seperti masalah selesai tanpa operator, tujuan tercapai, CSAT, pembukaan ulang, dan eskalasi. Anda dapat menyaring menurut periode, agen dan versinya, saluran, bahasa, segmen, sumber, serta hasil; data dapat dikelompokkan per hari atau jam.

AI → Kualitas jawaban menampilkan daftar percakapan agen. Dalam setiap percakapan terlihat status agen serta metrik teknis setiap jawaban: keyakinan, waktu respons, jumlah token, dan biaya. Isi pesan tetap berada di percakapan dukungan yang dapat dibuka melalui tautan. Peninjau dapat memberi nilai Benar, Salah, atau Tidak aman, beserta alasan dan komentar; penilaian dapat diekspor. Tampilan dan ekspor menyembunyikan data sensitif.

Setiap giliran menyimpan jumlah token masuk dan keluar serta biaya jika penyedia melaporkannya. Karena itu, pemakaian model dapat dilihat menurut agen dan periode.

Managed AI

Pada pengaturan agen, pilih sumber model secara jelas: integrasi AI Anda sendiri atau produk Managed AI milik akun. Jika kunci pribadi Anda salah, permintaan tidak otomatis dipindahkan ke Managed AI berbayar. Profil Managed AI adalah fast, balanced, dan quality. Profil menentukan cara memilih layanan model, bukan satu model tetap.

Produk menunjukkan kredit bulanan yang termasuk dalam paket, batas bulanan tetap, dan biaya tambahan. Bandingkan sebelum memilih paket. Untuk permintaan API langsung, gunakan token pribadi dengan hak managed_ai:invoke dan Idempotency-Key; membaca penggunaan memerlukan managed_ai:usage:read. Simpan token di server Anda. Alamat permintaan dijelaskan di REST API.

Langkah berikutnya