Integrasi Wagtail
Asisten AI yang menjawab pertanyaan di situs Wagtail Anda
Ringkasan
Paket Wagtail menempatkan asisten AI di situs Anda. Tombol obrolan berada di sudut setiap halaman, pengunjung bertanya dengan kata-kata mereka sendiri, dan jawabannya berasal dari konten Anda sendiri: situs web Anda, dokumen yang Anda unggah, dan artikel bantuan Anda.
Catatan tentang AI: Jawaban di situs Anda dibuat oleh AI. Kadang jawabannya bisa keliru atau tidak lengkap. Periksa dulu sebelum Anda mengandalkannya, terutama untuk keputusan penting.
Cara Kerjanya
Paket menambahkan middleware yang menempatkan satu skrip kecil tepat sebelum tag penutup body di setiap halaman. Skrip itu menunggu halaman selesai dimuat, lalu mengambil widget obrolan dari Asyntai, sehingga situs Anda digambar lebih dulu dan kecepatan halaman tidak berubah. Server Anda tidak pernah berbicara dengan Asyntai; hanya peramban pengunjung yang melakukannya.
Anda tidak mengubah apa pun di templat Anda. Middleware membiarkan panel admin Wagtail apa adanya, dan membiarkan apa pun yang bukan halaman HTML.
Persyaratan
- Akun Asyntai. Paket gratis sudah cukup untuk memulai.
- Situs Wagtail versi 5.2 atau lebih baru, dengan Django 4.2 atau lebih baru dan Python 3.9 atau lebih baru.
- Akses ke kode situs itu, karena Anda memasang paket Python.
Instalasi
Ikuti langkah-langkah ini untuk menambahkan Asyntai ke situs Wagtail Anda:
Pasang paketnya
Pasang dari Python Package Index, di lingkungan yang sama dengan situs Anda:
pip install wagtail-ai-chatbot
Tambahkan ke pengaturan Anda
Tambahkan aplikasi dan modul pengaturan Wagtail ke INSTALLED_APPS, dan middleware di bagian atas MIDDLEWARE:
INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
Jalankan migrasi
Ini membuat tabel yang menyimpan pengaturan Anda:
python manage.py migrate wagtail_asyntai
Tempelkan ID widget Anda
Di panel admin Wagtail, buka Settings lalu Asyntai chat assistant. Tempel ID widget Anda dan pilih Save. Anda menemukan ID itu di Dasbor Asyntai pada bagian Setup & Integration. Anda boleh menempel seluruh potongan kode; paket hanya menyimpan ID-nya.
Tip: Sebelum menerbitkan, tambahkan dokumen, tanya jawab, dan instruksi Anda di dasbor Asyntai, agar asisten menjawab dengan benar sejak pengunjung pertama.
Pengaturan
- ID widget: obrolan menyala selama kolom ini berisi ID yang sah, dan mati saat kolom kosong.
- Tampilkan obrolan hanya untuk pengunjung yang belum masuk: pengguna yang sudah masuk tidak pernah melihat obrolan. Berguna saat asisten hadir untuk orang yang belum mendaftar.
- Alamat skrip widget: biarkan nilai ini apa adanya, kecuali dukungan Asyntai meminta Anda mengubahnya.
Pengaturan berlaku per situs, jadi proyek yang melayani beberapa situs dari satu pemasangan Wagtail dapat memberi setiap situs asistennya sendiri.
Pengaturan di Berkas Pengaturan Anda
Proyek yang menyimpan konfigurasinya di variabel lingkungan dapat melewati panel admin dan menaruh nilainya di kode. Jika keduanya terisi, panel admin yang menang.
ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"
Tiga nilai lain bersifat pilihan: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL, dan ASYNTAI_SKIP_PREFIXES. Yang terakhir menyebutkan jalur yang tidak pernah disentuh widget, dan Anda memerlukannya bila panel admin Anda tidak berada di /admin/.
Menempatkan Widget dengan Tangan
Kalau Anda lebih suka memilih tempatnya sendiri, lewati middleware dan taruh tag di templat dasar Anda. Tag dan middleware tidak pernah aktif keduanya, jadi aman menyimpan keduanya.
{% load asyntai %} ... {% asyntai_widget %}
Apa yang bisa dilakukan asisten
- Menjawab pertanyaan pengunjung seketika, sepanjang hari, di setiap halaman
- Menjawab dalam lebih dari 80 bahasa, dikenali otomatis dari pertanyaannya
- Tetap terbuka saat pengunjung berpindah dari halaman ke halaman
- Memakai dokumen yang Anda unggah, tanya jawab, dan instruksi Anda untuk jawaban yang tepat
Privasi
Paket menerbitkan tepat dua nilai ke halaman: ID widget dan alamat skrip. Tidak ada apa pun tentang halaman atau pengguna Anda yang dikirim ke Asyntai. Hanya peramban pengunjung yang berbicara dengan Asyntai, dan hanya saat pengunjung membuka obrolan.
Paket dan harga
Integrasi Wagtail tersedia di semua paket Asyntai, termasuk paket gratis. Setiap paket mencakup jatah pesan bulanan yang dibagi di seluruh saluran dan integrasi Anda. Lihat harga.
Menghapus aplikasi
Kosongkan kolom ID widget untuk mematikan obrolan. Untuk menghapus paketnya, keluarkan middleware dan aplikasi dari pengaturan Anda lalu hapus dengan pip.
Kode Sumber
Paket ini bebas dan sumber terbuka, di bawah lisensi MIT. Anda dapat membaca setiap barisnya di GitHub.
Butuh Bantuan?
Jika Anda memiliki pertanyaan atau mengalami masalah, hubungi kami di [email protected].