Integrasi Wagtail
Pembantu AI yang menjawab soalan di laman Wagtail anda
Gambaran Keseluruhan
Pakej Wagtail meletakkan pembantu AI di laman anda. Butang sembang berada di sudut setiap halaman, pelawat bertanya dengan perkataan mereka sendiri, dan jawapan datang daripada kandungan anda sendiri: laman web anda, dokumen yang anda muat naik dan artikel bantuan anda.
Nota tentang AI: Jawapan di laman anda dihasilkan oleh AI. Kadangkala jawapan itu boleh salah atau tidak lengkap. Semak dahulu sebelum anda bergantung padanya, terutamanya untuk keputusan penting.
Cara Ia Berfungsi
Pakej menambah middleware yang meletakkan satu skrip kecil tepat sebelum tag penutup body pada setiap halaman. Skrip itu menunggu halaman selesai dimuatkan, kemudian mengambil widget sembang daripada Asyntai, jadi laman anda dilukis dahulu dan kelajuan halaman tidak berubah. Pelayan anda tidak pernah bercakap dengan Asyntai; hanya pelayar pelawat yang berbuat demikian.
Anda tidak mengubah apa-apa dalam templat anda. Middleware membiarkan panel pentadbiran Wagtail, dan membiarkan apa sahaja yang bukan halaman HTML.
Keperluan
- Akaun Asyntai. Pelan percuma sudah memadai untuk bermula.
- Laman Wagtail versi 5.2 atau lebih baharu, dengan Django 4.2 atau lebih baharu dan Python 3.9 atau lebih baharu.
- Akses kepada kod laman itu, kerana anda memasang pakej Python.
Pemasangan
Ikut langkah-langkah ini untuk menambah Asyntai ke laman Wagtail anda:
Pasang pakej
Pasang daripada Python Package Index, dalam persekitaran yang sama dengan laman anda:
pip install wagtail-ai-chatbot
Tambah ke tetapan anda
Tambah aplikasi dan modul tetapan Wagtail ke INSTALLED_APPS, dan middleware di bahagian atas MIDDLEWARE:
INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
Jalankan migrasi
Ini mencipta jadual yang menyimpan tetapan anda:
python manage.py migrate wagtail_asyntai
Tampalkan ID widget anda
Dalam panel pentadbiran Wagtail, buka Settings kemudian Asyntai chat assistant. Tampal ID widget anda dan pilih Save. Anda menemui ID itu dalam Papan Pemuka Asyntai di bawah Setup & Integration. Anda boleh menampal keseluruhan cebisan kod; pakej hanya menyimpan ID.
Petua: Sebelum menerbitkan, tambah dokumen anda, soal jawab anda dan arahan anda dalam papan pemuka Asyntai, supaya pembantu menjawab dengan betul sejak pelawat pertama.
Tetapan
- ID widget: sembang hidup selagi medan ini mengandungi ID yang sah, dan mati apabila medan kosong.
- Tunjukkan sembang hanya kepada pelawat yang belum log masuk: pengguna yang telah log masuk tidak pernah melihat sembang. Berguna apabila pembantu itu untuk orang yang belum mendaftar.
- Alamat skrip widget: biarkan nilai ini seperti sedia ada, melainkan sokongan Asyntai meminta anda mengubahnya.
Tetapan adalah bagi setiap laman, jadi projek yang menyajikan beberapa laman daripada satu pemasangan Wagtail boleh memberi setiap laman pembantunya sendiri.
Tetapan dalam Fail Tetapan Anda
Projek yang menyimpan konfigurasinya dalam pemboleh ubah persekitaran boleh melangkau panel pentadbiran dan meletakkan nilai dalam kod. Jika kedua-duanya diisi, panel pentadbiran menang.
ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"
Tiga nilai lain adalah pilihan: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL dan ASYNTAI_SKIP_PREFIXES. Yang terakhir menamakan laluan yang tidak pernah disentuh widget, dan anda memerlukannya apabila panel pentadbiran anda bukan di /admin/.
Meletakkan Widget dengan Tangan
Jika anda lebih suka memilih tempatnya sendiri, tinggalkan middleware dan letakkan tag dalam templat asas anda. Tag dan middleware tidak pernah aktif kedua-duanya, jadi selamat menyimpan kedua-duanya.
{% load asyntai %} ... {% asyntai_widget %}
Apa yang boleh dilakukan pembantu
- Menjawab soalan pelawat dengan serta-merta, siang dan malam, di setiap halaman
- Menjawab dalam lebih daripada 80 bahasa, dikesan secara automatik daripada soalan
- Kekal terbuka semasa pelawat berpindah dari halaman ke halaman
- Menggunakan dokumen yang anda muat naik, soalan lazim, dan arahan anda untuk jawapan yang tepat
Privasi
Pakej menerbitkan tepat dua nilai ke halaman: ID widget dan alamat skrip. Tiada apa-apa tentang halaman atau pengguna anda dihantar ke Asyntai. Hanya pelayar pelawat bercakap dengan Asyntai, dan hanya apabila pelawat membuka sembang.
Pelan dan harga
Integrasi Wagtail tersedia pada semua pelan Asyntai, termasuk pelan percuma. Setiap pelan merangkumi bilangan mesej bulanan yang dikongsi merentas semua saluran dan integrasi anda. Lihat harga.
Menyahpasang
Kosongkan medan ID widget untuk mematikan sembang. Untuk membuang pakej, keluarkan middleware dan aplikasi daripada tetapan anda dan nyahpasang dengan pip.
Kod Sumber
Pakej ini bebas dan sumber terbuka, di bawah lesen MIT. Anda boleh membaca setiap baris di GitHub.
Perlukan Bantuan?
Jika anda mempunyai sebarang soalan atau menghadapi masalah, hubungi kami di [email protected].