Wagtail-integrasjon
En AI-assistent som svarer på spørsmål på Wagtail-nettstedet ditt
Oversikt
Wagtail-pakken setter en AI-assistent på nettstedet ditt. En chatteknapp sitter i hjørnet på hver side, de besøkende stiller spørsmålet med egne ord, og svaret kommer fra ditt eget innhold: nettstedet ditt, dokumentene du har lastet opp og hjelpeartiklene dine.
KI-forbehold: Svarene på nettstedet ditt lages av AI. De kan av og til være feil eller ufullstendige. Sjekk dem før du stoler på dem, særlig ved viktige avgjørelser.
Slik fungerer det
Pakken legger til en mellomvare som setter ett lite skript rett før den avsluttende body-taggen på hver side. Skriptet venter til siden er ferdig lastet, og henter så chatte-widgeten fra Asyntai, slik at nettstedet ditt tegnes først og sidehastigheten er uendret. Serveren din snakker aldri med Asyntai, bare nettleseren til den besøkende gjør det.
Du endrer ingenting i malene dine. Mellomvaren lar Wagtail-administrasjonen være i fred, og lar alt være i fred som ikke er en HTML-side.
Krav
- En Asyntai-konto. Det gratis abonnementet holder til å komme i gang.
- Et Wagtail-nettsted, versjon 5.2 eller nyere, på Django 4.2 eller nyere og Python 3.9 eller nyere.
- Tilgang til koden for det nettstedet, fordi du installerer en Python-pakke.
Installasjon
Følg disse trinnene for å legge Asyntai til Wagtail-nettstedet ditt:
Installer pakken
Installer den fra Python Package Index, i samme miljø som nettstedet ditt:
pip install wagtail-ai-chatbot
Legg den til i innstillingene
Legg appen og Wagtails innstillingsmodul til i INSTALLED_APPS, og mellomvaren øverst i MIDDLEWARE:
INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
Kjør migreringen
Den lager tabellen som holder innstillingene dine:
python manage.py migrate wagtail_asyntai
Lim inn widget-ID-en din
Åpne Settings i Wagtail-administrasjonen og så Asyntai chat assistant. Lim inn widget-ID-en din og velg Save. Du finner ID-en i Asyntai-dashbordet under Setup & Integration. Du kan lime inn hele kodebiten, pakken beholder bare ID-en.
Tips: Legg inn dokumentene dine, spørsmålene og svarene dine og instruksjonene dine i Asyntai-oversikten før du publiserer, slik at assistenten svarer riktig allerede for den første besøkende.
Innstillinger
- Widget-ID: chatten er på så lenge feltet har en gyldig ID, og av når det er tomt.
- Vis chatten bare for utloggede besøkende: innloggede brukere ser aldri chatten. Nyttig når assistenten er der for dem som ennå ikke har registrert seg.
- Adressen til widget-skriptet: la denne verdien stå som den er, med mindre støtten hos Asyntai ber deg endre den.
Innstillingene er per nettsted, så et prosjekt som kjører flere nettsteder fra én Wagtail-installasjon kan gi hvert nettsted sin egen assistent.
Innstillinger i innstillingsfilen din
Et prosjekt som holder oppsettet sitt i miljøvariabler, kan hoppe over administrasjonen og sette verdiene i koden. Er begge fylt ut, vinner administrasjonen.
ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"
Tre andre verdier er valgfrie: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL og ASYNTAI_SKIP_PREFIXES. Den siste navngir stiene widgeten aldri rører, og den trenger du når administrasjonen din ikke ligger på /admin/.
Plassere widgeten for hånd
Vil du heller velge stedet selv, la mellomvaren være og sett taggen i basismalen din. Taggen og mellomvaren gjør aldri jobben begge, så du kan beholde begge.
{% load asyntai %} ... {% asyntai_widget %}
Hva assistenten kan
- Svare på spørsmål fra besøkende med en gang, døgnet rundt, på hver side
- Svare på mer enn 80 språk, som gjenkjennes automatisk fra spørsmålet
- Bli stående åpen mens den besøkende går fra side til side
- Bruke dokumentene du har lastet opp, vanlige spørsmål og instruksjoner for treffsikre svar
Personvern
Pakken publiserer nøyaktig to verdier på siden: widget-ID og adressen til skriptet. Ingenting om sidene eller brukerne dine sendes til Asyntai. Bare nettleseren til den besøkende snakker med Asyntai, og bare når den besøkende åpner chatten.
Abonnementer og priser
Wagtail-integrasjonen er med i alle Asyntai-planer, også den gratis. Hver plan inneholder et månedlig antall meldinger som deles mellom alle kanalene og integrasjonene dine. Se priser.
Avinstallering
Tøm feltet med widget-ID for å slå av chatten. For å fjerne pakken tar du mellomvaren og appen ut av innstillingene og avinstallerer den med pip.
Kildekode
Pakken er fri og åpen kildekode, under MIT-lisensen. Du kan lese hver linje på GitHub.
Trenger du hjelp?
Hvis du har spørsmål eller støter på problemer, kontakt oss på [email protected].