Wagtail Entegrasyonu
Wagtail sitenizdeki soruları yanıtlayan bir yapay zekâ asistanı
Genel Bakış
Wagtail paketi sitenize bir yapay zekâ asistanı koyar. Her sayfanın köşesinde bir sohbet düğmesi durur, ziyaretçiler sorularını kendi kelimeleriyle sorar ve yanıt sizin kendi içeriğinizden gelir: sitenizden, yüklediğiniz belgelerden ve yardım makalelerinizden.
Yapay zeka uyarısı: Sitenizdeki yanıtları yapay zekâ üretir. Bazen yanlış veya eksik olabilirler. Onlara güvenmeden önce doğrulayın, özellikle önemli kararlarda.
Nasıl Çalışır
Paket, her sayfanın kapanış body etiketinden hemen önce küçük bir betik koyan bir ara katman ekler. Betik sayfanın yüklenmesini bekler, sonra sohbet bileşenini Asyntai'den alır; böylece önce siteniz çizilir ve sayfa hızı değişmez. Sunucunuz Asyntai ile hiç konuşmaz, bunu yalnızca ziyaretçinin tarayıcısı yapar.
Şablonlarınızda hiçbir şeyi değiştirmezsiniz. Ara katman Wagtail yönetim alanına dokunmaz ve HTML sayfası olmayan hiçbir şeye dokunmaz.
Gereksinimler
- Bir Asyntai hesabı. Başlamak için ücretsiz plan yeterlidir.
- Wagtail 5.2 veya daha yeni bir site, Django 4.2 veya daha yeni ve Python 3.9 veya daha yeni sürümde.
- O sitenin koduna erişim, çünkü bir Python paketi kurarsınız.
Kurulum
Asyntai'yi Wagtail sitenize eklemek için şu adımları izleyin:
Paketi kurun
Python Package Index'ten, sitenizle aynı ortamda kurun:
pip install wagtail-ai-chatbot
Ayarlarınıza ekleyin
Uygulamayı ve Wagtail ayar modülünü INSTALLED_APPS listesine, ara katmanı da MIDDLEWARE listesinin başına ekleyin:
INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
Geçişi çalıştırın
Bu, ayarlarınızı tutan tabloyu oluşturur:
python manage.py migrate wagtail_asyntai
Widget kimliğinizi yapıştırın
Wagtail yönetim alanında Settings, sonra Asyntai chat assistant bölümünü açın. Bileşen kimliğinizi yapıştırın ve Save seçin. Kimliği Asyntai kontrol panelinizde Setup & Integration bölümünde bulursunuz. Kod parçasının tamamını yapıştırabilirsiniz, paket yalnızca kimliği saklar.
İpucu: Yayınlamadan önce belgelerinizi, soru ve yanıtlarınızı ve yönergelerinizi Asyntai panosuna ekleyin, böylece asistan daha ilk ziyaretçiye doğru yanıt verir.
Ayarlar
- Widget kimliği: bu alanda geçerli bir kimlik durduğu sürece sohbet açıktır, alan boşken kapalıdır.
- Sohbeti yalnızca oturum açmamış ziyaretçilere göster: oturum açmış kullanıcılar sohbeti hiç görmez. Asistan henüz kaydolmamış kişiler için varsa işe yarar.
- Widget betiğinin adresi: Asyntai desteği sizden değiştirmenizi istemedikçe bu değeri olduğu gibi bırakın.
Ayarlar site başınadır, bu yüzden tek bir Wagtail kurulumundan birkaç siteyi çalıştıran bir proje her siteye kendi asistanını verebilir.
Ayar Dosyanızdaki Ayarlar
Yapılandırmasını ortam değişkenlerinde tutan bir proje yönetim alanını atlayıp değerleri kodda verebilir. İkisi de doluysa yönetim alanı kazanır.
ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"
Üç değer daha isteğe bağlıdır: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL ve ASYNTAI_SKIP_PREFIXES. Sonuncusu bileşenin hiç dokunmadığı yolları sayar ve yönetim alanınız /admin/ adresinde değilse gerekir.
Bileşeni Elle Yerleştirmek
Yeri kendiniz seçmeyi yeğlerseniz ara katmanı bırakın ve etiketi temel şablonunuza koyun. Etiket ile ara katman hiçbir zaman ikisi birden çalışmaz, bu yüzden ikisini de tutabilirsiniz.
{% load asyntai %} ... {% asyntai_widget %}
Asistan neler yapabilir
- Ziyaretçi sorularını hemen yanıtlamak, gece gündüz, her sayfada
- 80'den fazla dilde yanıt verir, dili sorudan kendiliğinden anlar
- Ziyaretçi sayfadan sayfaya geçerken açık kalmak
- Doğru yanıtlar için yüklediğiniz belgeleri, sık sorulan soruları ve yönergelerinizi kullanır
Gizlilik
Paket sayfaya tam olarak iki değer koyar: bileşen kimliği ve betik adresi. Sayfalarınız veya kullanıcılarınız hakkında hiçbir şey Asyntai'ye gönderilmez. Asyntai ile yalnızca ziyaretçinin tarayıcısı konuşur, o da ancak ziyaretçi sohbeti açtığında.
Planlar ve fiyatlar
Wagtail entegrasyonu, ücretsiz plan dahil tüm Asyntai planlarında vardır. Her plan, tüm kanallarınız ve entegrasyonlarınız arasında paylaşılan aylık bir mesaj hakkı içerir. Fiyatlandırmayı görün.
Kaldırma
Sohbeti kapatmak için bileşen kimliği alanını boşaltın. Paketi kaldırmak için ara katmanı ve uygulamayı ayarlarınızdan çıkarın ve pip ile kaldırın.
Kaynak Kodu
Paket özgür ve açık kaynaklıdır, MIT lisansı altındadır. Her satırı GitHub üzerinde okuyabilirsiniz.
Yardıma mı İhtiyacınız Var?
Herhangi bir sorunuz varsa veya sorunla karşılaşırsanız, [email protected] adresinden bizimle iletişime geçin.