Wagtail-integration
En AI-assistent som svarar på frågor på din Wagtail-webbplats
Översikt
Wagtail-paketet sätter en AI-assistent på din webbplats. En chattknapp sitter i hörnet på varje sida, besökarna ställer sin fråga med egna ord, och svaret kommer från ditt eget innehåll: din webbplats, dina uppladdade dokument och dina hjälpartiklar.
AI-förbehåll: Svaren på din webbplats skapas av AI. Ibland kan de vara felaktiga eller ofullständiga. Kontrollera dem innan du litar på dem, särskilt vid viktiga beslut.
Hur det fungerar
Paketet lägger till en mellanprogramvara som sätter ett litet skript precis före den avslutande body-taggen på varje sida. Skriptet väntar tills sidan har laddat klart och hämtar sedan chattwidgeten från Asyntai, så din webbplats ritas först och sidans hastighet är oförändrad. Din server talar aldrig med Asyntai, bara besökarens webbläsare gör det.
Du ändrar ingenting i dina mallar. Mellanprogramvaran lämnar Wagtails administration i fred, och lämnar i fred allt som inte är en HTML-sida.
Krav
- Ett Asyntai-konto. Det kostnadsfria paketet räcker för att komma igång.
- En Wagtail-webbplats, version 5.2 eller nyare, på Django 4.2 eller nyare och Python 3.9 eller nyare.
- Tillgång till koden för den webbplatsen, eftersom du installerar ett Python-paket.
Installation
Följ dessa steg för att lägga till Asyntai på din Wagtail-webbplats:
Installera paketet
Installera det från Python Package Index, i samma miljö som din webbplats:
pip install wagtail-ai-chatbot
Lägg till det i dina inställningar
Lägg till appen och Wagtails inställningsmodul i INSTALLED_APPS, och mellanprogramvaran högst upp i MIDDLEWARE:
INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
Kör migreringen
Den skapar tabellen som håller dina inställningar:
python manage.py migrate wagtail_asyntai
Klistra in ditt widget-ID
Öppna Settings i Wagtails administration och sedan Asyntai chat assistant. Klistra in ditt widget-ID och välj Save. Du hittar ID:t i din Asyntai-instrumentpanel under Setup & Integration. Du kan klistra in hela kodsnutten, paketet behåller bara ID:t.
Tips: Lägg till dina dokument, dina frågor och svar och dina instruktioner i Asyntai-instrumentpanelen innan du publicerar, så att assistenten svarar rätt redan för den första besökaren.
Inställningar
- Widget-ID: chatten är på så länge fältet innehåller ett giltigt ID, och av när det är tomt.
- Visa chatten bara för utloggade besökare: inloggade användare ser aldrig chatten. Bra när assistenten finns för dem som ännu inte har registrerat sig.
- Adress till widgetskriptet: låt värdet stå som det är, om inte Asyntais support ber dig ändra det.
Inställningarna gäller per webbplats, så ett projekt som kör flera webbplatser från en Wagtail-installation kan ge varje webbplats en egen assistent.
Inställningar i din inställningsfil
Ett projekt som håller sin konfiguration i miljövariabler kan hoppa över administrationen och sätta värdena i koden. Är båda ifyllda vinner administrationen.
ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"
Tre andra värden är valfria: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL och ASYNTAI_SKIP_PREFIXES. Det sista namnger de sökvägar som widgeten aldrig rör, och du behöver det när din administration inte ligger på /admin/.
Placera widgeten för hand
Vill du hellre välja plats själv, hoppa över mellanprogramvaran och sätt taggen i din basmall. Taggen och mellanprogramvaran gör aldrig båda jobbet, så du kan behålla båda.
{% load asyntai %} ... {% asyntai_widget %}
Vad assistenten kan
- Svara på besökarnas frågor direkt, dygnet runt, på varje sida
- Svara på fler än 80 språk, som känns igen automatiskt utifrån frågan
- Vara kvar öppen medan besökaren går från sida till sida
- Använda dina egna uppladdade dokument, vanliga frågor och instruktioner för träffsäkra svar
Integritet
Paketet publicerar exakt två värden på sidan: widget-ID och skriptets adress. Ingenting om dina sidor eller dina användare skickas till Asyntai. Bara besökarens webbläsare talar med Asyntai, och bara när besökaren öppnar chatten.
Paket och priser
Wagtail-integrationen ingår i alla Asyntai-planer, även den kostnadsfria. Varje plan innehåller ett månatligt antal meddelanden som delas mellan alla dina kanaler och integrationer. Visa priser.
Avinstallation
Töm fältet med widget-ID för att stänga av chatten. För att ta bort paketet, plocka bort mellanprogramvaran och appen ur dina inställningar och avinstallera det med pip.
Källkod
Paketet är fritt och öppen källkod, under MIT-licens. Du kan läsa varje rad på GitHub.
Behöver du hjälp?
Om du har några frågor eller stöter på problem, kontakta oss på [email protected].