Ringkasan

Status chatbot dan apa yang perlu disiapkan sebelum dipasang di website.

–pertanyaan pengunjung, 7 hari

–tidak ditemukan di dokumen

–gagal karena penyedia AI

Persiapan

Selesaikan semua langkah agar chatbot siap menjawab pengunjung.

Urutan penyedia AI

Jika penyedia pertama gagal, kuotanya habis, atau terlalu lambat, chatbot otomatis pindah ke penyedia berikutnya.

Atur

Embedding untuk unggahan berikutnya: –

Dokumen

Chatbot hanya menjawab dari satu dokumen ini. Dokumen dipotong di browser, lalu tiap potongan diubah menjadi vektor dan diindeks untuk pencarian kata kunci.

Unggah dokumen

Paling akurat: .md dengan judul bagian (#, ##). Juga didukung .txt, .csv, .json, .html, .pdf (berbasis teks), dan .docx. Maksimal 10 MB.

Pilih file atau seret ke sini Dokumen dibaca di browser Anda; yang dikirim ke server hanya potongan teksnya.

Bot & model

Identitas chatbot di widget, urutan model AI, dan kunci API.

Identitas

Nama chatbot Label tombol widget Warna utama

Warna teks tombol menyesuaikan otomatis agar tetap terbaca. Pesan saat jawaban tidak ada di dokumen

Sapaan pembuka (opsional) Saran pertanyaan manual (opsional)Kosongkan untuk memakai saran otomatis dari dokumen.

Bahasa default pengunjungDipakai jika bahasa browser pengunjung tidak terdeteksi. Pengunjung bisa mengganti bahasa lewat tombol ID/EN di widget.

Teks versi English

Ditampilkan saat pengunjung memilih EN. Kosongkan untuk memakai teks otomatis berbahasa Inggris.

Label tombol (English) Pesan penolakan (English) Sapaan pembuka (English) Saran pertanyaan (English)

Urutan model

Dicoba dari atas ke bawah. Gunakan tombol Tes untuk memastikan kunci dan nama model benar.

Cadangan Workers AITambahkan model Workers AI (gratis, tanpa kunci) di ujung rantai sebagai jaring pengaman.

Temperature0–0,3 = konsisten dan faktual. Maks. token jawaban Tingkat berpikir Gemini

Model embedding untuk unggahan berikutnya Dokumen yang sudah diunggah tetap memakai model saat unggah. Ganti model = unggah ulang dokumen.

Kunci API

Kunci disimpan di server dan tidak pernah ditampilkan lagi. Untuk keamanan maksimal, simpan sebagai secret Cloudflare (wrangler secret put); kunci yang ditempel di sini mengalahkan secret.

Pencarian (RAG)

Cara chatbot menemukan potongan dokumen yang relevan sebelum menjawab. Coba perubahan di menu Uji coba sebelum disimpan.

Alur pencarian

Tulis ulang pertanyaan lanjutan"Kalau yang kedua berapa?" diubah AI menjadi pertanyaan lengkap sebelum dicari. Menambah satu panggilan AI singkat.

Pencarian hibrida (vektor + kata kunci)Menangkap istilah persis seperti kode, nama, atau angka yang sering lolos dari pencarian makna.

Cache jawaban semantikPertanyaan yang sama atau bermakna mirip dijawab dari cache tanpa memanggil AI lagi, jadi hemat token. Otomatis diperbarui saat dokumen atau pengaturan berubah.

Urutkan ulang dengan rerankerModel bge-reranker menilai ulang 20 kandidat teratas. Paling efektif untuk dokumen berbahasa Inggris.

Reranker otomatis untuk dokumen berbahasa InggrisBahasa dokumen dideteksi saat diunggah. Bila berbahasa Inggris, reranker dinyalakan walau tombol di atas mati. Tidak memakai token AI.

Potongan dikirim ke AI

Ambang kemiripan minimum

Kandidat per pencarian

Potongan tetangga (±)

Kemiripan minimum untuk cache

Batas total konteks (karakter)

Cache: –

Ambang terlalu tinggi membuat bot sering bilang "tidak ada di dokumen"; terlalu rendah membuat AI menerima potongan yang tidak relevan. Lihat skor nyata di Uji coba untuk menentukan angka yang pas.

Batas pemakaian & anti-bot

Melindungi kuota gratis dan menjaga semua interaksi tetap organik: widget punya honeypot, permintaan tanpa User-Agent ditolak, dan setiap pengunjung dibatasi per menit dan per hari.

Maks. panjang pertanyaan Riwayat percakapan diingatJumlah pesan terakhir. Pertanyaan per menit / pengunjung Pertanyaan per hari / pengunjung Total pertanyaan per hari

Simpan riwayat pertanyaanUntuk melihat pertanyaan yang belum terjawab dokumen. Alamat IP tidak disimpan.

Uji coba

Tanya seperti pengunjung, lalu lihat potongan mana yang ditemukan dan kenapa. Uji coba dicatat terpisah dan tidak dihitung sebagai pertanyaan pengunjung.

Pakai pengaturan belum disimpanUji perubahan RAG/prompt sebelum menyimpan.

Belum ada percakapan. Coba salah satu saran pertanyaan di menu Dokumen.

Hasil pencarian

Potongan berwarna kunyit dikirim ke AI.

Kirim pertanyaan untuk melihat hasil pencarian.

Riwayat pertanyaan

Pertanyaan yang tidak terjawab menunjukkan informasi yang perlu ditambahkan ke dokumen.

Pasang widget

Tempel kode ini sebelum tag </body> di website Anda. Widget memakai Shadow DOM, jadi tampilannya tidak bentrok dengan CSS website.

Posisi Bahasa widget Tema

Domain yang diizinkan

Satu domain per baris, contoh https://tokosaya.com. Kosongkan untuk mengizinkan semua domain. Domain dashboard ini selalu diizinkan.

Telegram & WhatsApp

Bot yang sama bisa menjawab lewat chat Telegram dan WhatsApp, memakai dokumen, pengaturan, dan kuota yang sama dengan widget.

Memuat status saluran…

Ringkasan

Persiapan

Urutan penyedia AI

Dokumen

Unggah dokumen

–

Pratinjau potongan

–

Saran pertanyaan otomatis

Isi potongan tersimpan

Bot & model

Identitas

Teks versi English

Urutan model

Kunci API

Pencarian (RAG)

Alur pencarian

Batas pemakaian & anti-bot

Uji coba

Hasil pencarian

Riwayat pertanyaan

Pasang widget

Domain yang diizinkan

Telegram & WhatsApp

Masuk ke akun Anda

Ringkasan

Persiapan

Urutan penyedia AI

Dokumen

Unggah dokumen

–

Pratinjau potongan

–

Saran pertanyaan otomatis

Isi potongan tersimpan

Bot & model

Identitas

Teks versi English

Urutan model

Kunci API

Pencarian (RAG)

Alur pencarian

Batas pemakaian & anti-bot

Uji coba

Hasil pencarian

Riwayat pertanyaan

Pasang widget

Domain yang diizinkan

Telegram & WhatsApp