Wagtail-integration

En AI-assistent, der svarer på spørgsmål på dit Wagtail-websted

Oversigt

Wagtail-pakken sætter en AI-assistent på dit websted. En chatknap sidder i hjørnet af hver side, de besøgende stiller deres spørgsmål med egne ord, og svaret kommer fra dit eget indhold: dit websted, dine uploadede dokumenter og dine hjælpeartikler.

AI-forbehold: Svarene på dit websted er skabt af AI. De kan af og til være forkerte eller ufuldstændige. Kontroller dem, før du stoler på dem, især ved vigtige beslutninger.

Sådan fungerer det

Pakken tilføjer en middleware, der sætter et lille script lige før det afsluttende body-tag på hver side. Scriptet venter, til siden er indlæst, og henter derefter chatwidgeten hos Asyntai, så dit websted tegnes først, og sidens hastighed er uændret. Din server taler aldrig med Asyntai, kun den besøgendes browser gør det.

Du ændrer intet i dine skabeloner. Middlewaren lader Wagtails administration være, og lader alt være, som ikke er en HTML-side.

Krav

En Asyntai-konto. Det gratis abonnement er nok til at komme i gang.
Et Wagtail-websted, version 5.2 eller nyere, på Django 4.2 eller nyere og Python 3.9 eller nyere.
Adgang til koden for det websted, for du installerer en Python-pakke.

Installation

Følg disse trin for at føje Asyntai til dit Wagtail-websted:

Installer pakken

Installer den fra Python Package Index, i samme miljø som dit websted:

pip install wagtail-ai-chatbot

Føj den til dine indstillinger

Føj appen og Wagtails indstillingsmodul til INSTALLED_APPS, og middlewaren øverst i MIDDLEWARE:

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

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

Kør migreringen

Den opretter tabellen, der holder dine indstillinger:

python manage.py migrate wagtail_asyntai

Indsæt dit widget-ID

Åbn Settings i Wagtails administration og derefter Asyntai chat assistant. Indsæt dit widget-id, og vælg Save. Du finder id'et i dit Asyntai-dashboard under Setup & Integration. Du kan indsætte hele kodestumpen, pakken beholder kun id'et.

Tip: Tilføj dine dokumenter, dine spørgsmål og svar og dine instruktioner i Asyntai-kontrolpanelet, før du udgiver, så assistenten svarer rigtigt allerede over for den første besøgende.

Indstillinger

Widget-id: chatten er tændt, så længe feltet indeholder et gyldigt id, og slukket, når det er tomt.
Vis kun chatten for besøgende, der ikke er logget ind: brugere, der er logget ind, ser aldrig chatten. Nyttigt, når assistenten er der for dem, der endnu ikke har oprettet sig.
Adresse på widgetscriptet: lad værdien stå, som den er, medmindre Asyntais support beder dig om at ændre den.

Indstillingerne er pr. websted, så et projekt, der kører flere websteder fra én Wagtail-installation, kan give hvert websted sin egen assistent.

Indstillinger i din indstillingsfil

Et projekt, der holder sin opsætning i miljøvariabler, kan springe administrationen over og sætte værdierne i koden. Er begge udfyldt, vinder administrationen.

ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"

Tre andre værdier er valgfri: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL og ASYNTAI_SKIP_PREFIXES. Den sidste nævner de stier, widgeten aldrig rører, og den skal du bruge, når din administration ikke ligger på /admin/.

Placer widgeten i hånden

Vil du hellere vælge stedet selv, så lad middlewaren være og sæt tagget i din basisskabelon. Tagget og middlewaren udløses aldrig begge, så du kan beholde begge.

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

Hvad assistenten kan

Svare på de besøgendes spørgsmål med det samme, døgnet rundt, på hver side
Svare på mere end 80 sprog, som genkendes automatisk ud fra spørgsmålet
Blive åben, mens den besøgende går fra side til side
Bruge dine egne uploadede dokumenter, ofte stillede spørgsmål og instruktioner til præcise svar

Privatliv

Pakken offentliggør præcis to værdier på siden: widget-id og scriptets adresse. Intet om dine sider eller dine brugere sendes til Asyntai. Kun den besøgendes browser taler med Asyntai, og kun når den besøgende åbner chatten.

Abonnementer og priser

Wagtail-integrationen er med i alle Asyntai-planer, også den gratis. Hver plan indeholder et månedligt antal beskeder, som deles mellem alle dine kanaler og integrationer. Se priser.

Afinstallation

Tøm feltet med widget-id for at slukke chatten. For at fjerne pakken tager du middlewaren og appen ud af dine indstillinger og afinstallerer den med pip.

Kildekode

Pakken er fri og open source, under MIT-licensen. Du kan læse hver linje på GitHub.

Brug for hjælp?

Hvis du har spørgsmål eller støder på problemer, kan du kontakte os på [email protected].

Dokumentation