Natrag na nadzornu ploču

Dokumentacija

Naučite kako koristiti Asyntai

Integracija s Wagtailom

AI asistent koji odgovara na pitanja na vašoj Wagtail stranici

Idi na nadzornu ploču

Pregled

Wagtail paket stavlja AI asistenta na vašu stranicu. Gumb za chat stoji u kutu svake stranice, posjetitelji postave pitanje svojim riječima, a odgovor dolazi iz vašeg sadržaja: vaše web stranice, prenesenih dokumenata i članaka pomoći.

Napomena o AI: Odgovore na vašoj stranici stvara umjetna inteligencija. Ponekad mogu biti netočni ili nepotpuni. Provjerite ih prije nego se na njih oslonite, osobito kod važnih odluka.

Kako funkcionira

Paket dodaje middleware koji stavlja jednu malu skriptu točno prije zatvarajuće body oznake na svakoj stranici. Skripta čeka da se stranica učita, pa tek onda dohvaća chat widget s Asyntai, tako da se vaša stranica iscrtava prva i brzina stranice se ne mijenja. Vaš poslužitelj nikada ne razgovara s Asyntai, to radi samo preglednik posjetitelja.

U predlošcima ne mijenjate ništa. Middleware ne dira Wagtail administraciju i ne dira ništa što nije HTML stranica.

Zahtjevi

  • Asyntai račun. Za početak je dovoljan besplatni plan.
  • Stranica na Wagtailu verzije 5.2 ili novije, na Djangu 4.2 ili novijem i Pythonu 3.9 ili novijem.
  • Pristup kodu te stranice, jer instalirate Python paket.

Instalacija

Slijedite ove korake da dodate Asyntai na svoju Wagtail stranicu:

1

Instalirajte paket

Instalirajte ga s Python Package Indexa, u istom okruženju u kojem radi vaša stranica:

pip install wagtail-ai-chatbot
2

Dodajte ga u postavke

Dodajte aplikaciju i Wagtail modul postavki u INSTALLED_APPS, a middleware na početak MIDDLEWARE:

INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
3

Pokrenite migraciju

Ona stvara tablicu koja čuva vaše postavke:

python manage.py migrate wagtail_asyntai
4

Zalijepite ID svojeg widgeta

U Wagtail administraciji otvorite Settings, pa Asyntai chat assistant. Zalijepite svoj ID widgeta i odaberite Save. ID pronalazite na svojoj Asyntai nadzornoj ploči u odjeljku Setup & Integration. Možete zalijepiti cijeli isječak koda, paket zadržava samo ID.

Savjet: Dodajte svoje dokumente, svoja pitanja i odgovore i svoje upute u Asyntai nadzornoj ploči prije objave, kako bi pomoćnik točno odgovorio već prvom posjetitelju.

Postavke

  • ID widgeta: chat radi dok je u ovom polju ispravan ID, a isključen je kada je polje prazno.
  • Prikaži chat samo odjavljenim posjetiteljima: prijavljeni korisnici nikada ne vide chat. Korisno kada je asistent tu da odgovara ljudima koji se još nisu registrirali.
  • Adresa skripte widgeta: ostavite ovu vrijednost kakva jest, osim ako vas podrška Asyntai ne zamoli da je promijenite.

Postavke su po stranici, pa projekt koji iz jedne Wagtail instalacije poslužuje više stranica može svakoj stranici dati vlastitog asistenta.

Postavke u vašoj datoteci postavki

Projekt koji konfiguraciju drži u varijablama okruženja može preskočiti administraciju i postaviti vrijednosti u kodu. Ako je popunjeno i jedno i drugo, pobjeđuje administracija.

ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"

Još tri vrijednosti nisu obavezne: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL i ASYNTAI_SKIP_PREFIXES. Zadnja navodi putanje koje widget nikada ne dira, i treba vam kada vaša administracija nije na /admin/.

Ručno postavljanje widgeta

Ako sami želite odabrati mjesto, izostavite middleware i stavite oznaku u svoj osnovni predložak. Oznaka i middleware nikada ne rade zajedno, pa možete zadržati oboje.

{% load asyntai %} ... {% asyntai_widget %}

Što asistent može

  • Odgovarati na pitanja posjetitelja odmah, danonoćno, na svakoj stranici
  • Odgovarati na više od 80 jezika, koje prepoznaje automatski iz pitanja
  • Ostati otvoren dok posjetitelj prelazi sa stranice na stranicu
  • Koristiti vaše prenesene dokumente, česta pitanja i upute za točne odgovore

Privatnost

Paket objavljuje na stranici točno dvije vrijednosti: ID widgeta i adresu skripte. Ništa o vašim stranicama ni o vašim korisnicima ne šalje se u Asyntai. S Asyntai razgovara samo preglednik posjetitelja, i to tek kada posjetitelj otvori chat.

Planovi i cijene

Integracija s Wagtailom dostupna je na svim Asyntai planovima, uključujući besplatni. Svaki plan uključuje mjesečni broj poruka koji dijelite preko svih svojih kanala i integracija. Pogledajte cijene.

Deinstalacija

Obrišite polje s ID-om widgeta da isključite chat. Da uklonite paket, izvadite middleware i aplikaciju iz postavki i deinstalirajte ga pomoću pip.

Izvorni kod

Paket je slobodan i otvorenog koda, pod MIT licencom. Svaku liniju možete pročitati na GitHubu.

Trebate pomoć?

Ako imate pitanja ili naiđete na probleme, kontaktirajte nas na [email protected].