Integrácia s Wagtailom

Asistent s umelou inteligenciou, ktorý odpovedá na otázky na vašom webe Wagtail

Prehľad

Balík pre Wagtail pridá na váš web asistenta s umelou inteligenciou. Tlačidlo chatu sedí v rohu každej stránky, návštevníci sa spýtajú vlastnými slovami a odpoveď vychádza z vášho vlastného obsahu: z vášho webu, z nahraných dokumentov a z článkov pomocníka.

Upozornenie k AI: Odpovede na vašom webe tvorí umelá inteligencia. Niekedy môžu byť nepresné alebo neúplné. Overte si ich, kým sa na ne spoľahnete, najmä pri dôležitých rozhodnutiach.

Ako to funguje

Balík pridá middleware, ktorý vloží jeden malý skript tesne pred uzatváraciu značku body na každej stránke. Skript počká, kým sa stránka načíta, a až potom stiahne widget chatu z Asyntai. Váš web sa tak vykreslí prvý a rýchlosť stránky sa nemení. Váš server s Asyntai nikdy nekomunikuje, robí to len prehliadač návštevníka.

V šablónach nemeníte nič. Middleware necháva administráciu Wagtailu na pokoji a necháva na pokoji všetko, čo nie je HTML stránka.

Požiadavky

Konto Asyntai. Na začiatok stačí bezplatná tarifa.
Web na Wagtaile verzie 5.2 alebo novšej, na Djangu 4.2 alebo novšom a Pythone 3.9 alebo novšom.
Prístup ku kódu toho webu, pretože inštalujete balík pre Python.

Inštalácia

Podľa týchto krokov pridáte Asyntai na svoj web Wagtail:

Nainštalujte balík

Nainštalujte ho z Python Package Indexu, v rovnakom prostredí ako váš web:

pip install wagtail-ai-chatbot

Pridajte ho do nastavení

Pridajte aplikáciu a modul nastavení Wagtailu do INSTALLED_APPS a middleware na začiatok MIDDLEWARE:

INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]

MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]

Spustite migráciu

Tá vytvorí tabuľku, ktorá drží vaše nastavenia:

python manage.py migrate wagtail_asyntai

Vložte svoje widget ID

V administrácii Wagtailu otvorte Settings a potom Asyntai chat assistant. Vložte svoje ID widgetu a zvoľte Save. ID nájdete vo svojom paneli Asyntai v sekcii Setup & Integration. Môžete vložiť celý úryvok kódu, balík si vezme len ID.

Tip: Pred publikovaním pridajte svoje dokumenty, otázky a odpovede a pokyny v prehľade Asyntai, aby asistent správne odpovedal už prvému návštevníkovi.

Nastavenia

ID widgetu: chat beží, kým je v tomto poli platné ID, a je vypnutý, keď je pole prázdne.
Zobraziť chat len odhláseným návštevníkom: prihlásení používatelia chat nikdy neuvidia. Hodí sa, keď má asistent odpovedať ľuďom, ktorí sa ešte nezaregistrovali.
Adresa skriptu widgetu: túto hodnotu nechajte tak, ako je, ak vás podpora Asyntai nepožiada o zmenu.

Nastavenie je zvlášť pre každý web, takže projekt, ktorý z jednej inštalácie Wagtailu obsluhuje viac webov, môže dať každému webu vlastného asistenta.

Nastavenia v súbore nastavení

Projekt, ktorý drží konfiguráciu v premenných prostredia, môže administráciu vynechať a nastaviť hodnoty v kóde. Keď sú vyplnené obe miesta, vyhráva administrácia.

ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"

Ďalšie tri hodnoty sú nepovinné: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL a ASYNTAI_SKIP_PREFIXES. Posledná menuje cesty, ktorých sa widget nikdy nedotkne, a potrebujete ju, keď vaša administrácia nebeží na /admin/.

Umiestnenie widgetu ručne

Ak si chcete miesto vybrať sami, middleware vynechajte a vložte značku do svojej základnej šablóny. Značka a middleware nikdy nezaberú obe, takže si môžete nechať oboje.

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

Čo asistent dokáže

Odpovedať na otázky návštevníkov okamžite, nepretržite, na každej stránke
Odpovedať vo viac ako 80 jazykoch, ktoré rozpozná automaticky z otázky
Zostať otvorený, keď návštevník prechádza zo stránky na stránku
Používať vaše nahrané dokumenty, časté otázky a pokyny pre presné odpovede

Ochrana osobných údajov

Balík zverejní na stránke presne dve hodnoty: ID widgetu a adresu skriptu. Nič o vašich stránkach ani o vašich používateľoch sa do Asyntai neposiela. S Asyntai hovorí len prehliadač návštevníka, a to až keď návštevník chat otvorí.

Tarify a ceny

Integrácia s Wagtailom je dostupná vo všetkých tarifách Asyntai vrátane bezplatnej. Každá tarifa obsahuje mesačný počet správ, ktorý zdieľate naprieč všetkými kanálmi a integráciami. Zobraziť ceny.

Odinštalovanie

Vymažte pole s ID widgetu, tým chat vypnete. Balík odstránite tak, že vyberiete middleware a aplikáciu z nastavení a odinštalujete ho príkazom pip.

Zdrojový kód

Balík je slobodný a s otvoreným kódom, pod licenciou MIT. Každý riadok si môžete prečítať na GitHube.

Potrebujete pomoc?

Ak máte akékoľvek otázky alebo narazíte na problémy, kontaktujte nás na [email protected].

Dokumentácia