Integrare cu Wagtail
Un asistent AI care răspunde la întrebări pe site-ul tău Wagtail
Prezentare generală
Pachetul Wagtail pune un asistent AI pe site-ul tău. Un buton de chat stă în colțul fiecărei pagini, vizitatorii pun întrebarea cu propriile cuvinte, iar răspunsul vine din conținutul tău: site-ul tău, documentele încărcate și articolele de ajutor.
Precizare privind AI: Răspunsurile de pe site-ul tău sunt create de AI. Uneori pot fi greșite sau incomplete. Verifică-le înainte să te bazezi pe ele, mai ales la decizii importante.
Cum funcționează
Pachetul adaugă un middleware care pune un script mic chiar înainte de eticheta de închidere body a fiecărei pagini. Scriptul așteaptă ca pagina să se încarce, apoi aduce widgetul de chat de la Asyntai, așa că site-ul tău se desenează primul și viteza paginii rămâne aceeași. Serverul tău nu vorbește niciodată cu Asyntai; doar browserul vizitatorului o face.
Nu schimbi nimic în șabloane. Middleware-ul lasă în pace administrarea Wagtail și lasă în pace tot ce nu este o pagină HTML.
Cerințe
- Un cont Asyntai. Planul gratuit este suficient pentru început.
- Un site Wagtail, versiunea 5.2 sau mai nouă, pe Django 4.2 sau mai nou și Python 3.9 sau mai nou.
- Acces la codul acelui site, pentru că instalezi un pachet Python.
Instalare
Urmează acești pași pentru a adăuga Asyntai pe site-ul tău Wagtail:
Instalează pachetul
Instalează-l din Python Package Index, în același mediu ca site-ul tău:
pip install wagtail-ai-chatbot
Adaugă-l în setări
Adaugă aplicația și modulul de setări Wagtail în INSTALLED_APPS, iar middleware-ul la începutul listei MIDDLEWARE:
INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
Rulează migrarea
Aceasta creează tabelul care păstrează setările tale:
python manage.py migrate wagtail_asyntai
Lipiți widget ID-ul
În administrarea Wagtail, deschide Settings și apoi Asyntai chat assistant. Lipește ID-ul widgetului și alege Save. Găsești ID-ul în panoul tău Asyntai, la Setup & Integration. Poți lipi tot fragmentul de cod; pachetul păstrează doar ID-ul.
Sfat: Adaugă documentele tale, întrebările și răspunsurile tale și instrucțiunile tale în panoul Asyntai înainte de publicare, ca asistentul să răspundă corect chiar de la primul vizitator.
Setări
- ID-ul widgetului: chatul este pornit cât timp acest câmp conține un ID valid și oprit când este gol.
- Arată chatul doar vizitatorilor nelogați: utilizatorii autentificați nu văd niciodată chatul. Util când asistentul este acolo pentru cei care încă nu s-au înscris.
- Adresa scriptului widgetului: lasă această valoare așa cum este, dacă suportul Asyntai nu îți cere să o schimbi.
Setările sunt pentru fiecare site în parte, așa că un proiect care servește mai multe site-uri dintr-o singură instalare Wagtail poate da fiecărui site propriul asistent.
Setări în fișierul tău de setări
Un proiect care ține configurarea în variabile de mediu poate sări peste administrare și pune valorile în cod. Dacă ambele sunt completate, câștigă administrarea.
ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"
Alte trei valori sunt opționale: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL și ASYNTAI_SKIP_PREFIXES. Ultima numește căile pe care widgetul nu le atinge niciodată, și îți trebuie când administrarea ta nu stă la /admin/.
Punerea widgetului cu mâna
Dacă preferi să alegi tu locul, lasă middleware-ul deoparte și pune eticheta în șablonul tău de bază. Eticheta și middleware-ul nu se declanșează niciodată amândouă, deci le poți păstra pe amândouă.
{% load asyntai %} ... {% asyntai_widget %}
Ce poate face asistentul
- Răspunde la întrebările vizitatorilor pe loc, non-stop, pe fiecare pagină
- Răspunde în peste 80 de limbi, recunoscute automat din întrebare
- Rămâne deschis cât timp vizitatorul trece de la o pagină la alta
- Folosește propriile documente încărcate, întrebările frecvente și instrucțiunile pentru răspunsuri exacte
Confidențialitate
Pachetul publică în pagină exact două valori: ID-ul widgetului și adresa scriptului. Nimic despre paginile tale sau despre utilizatorii tăi nu ajunge la Asyntai. Doar browserul vizitatorului vorbește cu Asyntai și doar când vizitatorul deschide chatul.
Planuri și prețuri
Integrarea cu Wagtail este disponibilă în toate planurile Asyntai, inclusiv cel gratuit. Fiecare plan include un număr lunar de mesaje, împărțit între toate canalele și integrările tale. Vezi prețurile.
Dezinstalare
Golește câmpul cu ID-ul widgetului ca să oprești chatul. Ca să scoți pachetul, ia middleware-ul și aplicația din setări și dezinstalează-l cu pip.
Cod sursă
Pachetul este liber și cu sursă deschisă, sub licența MIT. Poți citi fiecare rând pe GitHub.
Ai nevoie de ajutor?
Dacă ai întrebări sau întâmpini probleme, contactează-ne la [email protected].