Wagtail-integratie
Een AI-assistent die vragen beantwoordt op uw Wagtail-site
Overzicht
Het Wagtail-pakket zet een AI-assistent op uw site. Een chatknop staat in de hoek van elke pagina, bezoekers stellen hun vraag in hun eigen woorden, en het antwoord komt uit uw eigen inhoud: uw website, uw geüploade documenten en uw helpartikelen.
AI-disclaimer: Antwoorden op uw website komen van een AI. Ze kunnen soms onjuist of onvolledig zijn. Controleer ze voordat u erop vertrouwt, zeker bij belangrijke beslissingen.
Hoe het werkt
Het pakket voegt een middleware toe die één klein script vlak voor de sluitende body-tag van elke pagina zet. Dat script wacht tot de pagina klaar is met laden en haalt dan de chatwidget bij Asyntai, zodat uw site eerst getekend wordt en de laadtijd gelijk blijft. Uw server praat nooit met Asyntai; alleen de browser van de bezoeker doet dat.
U wijzigt niets in uw sjablonen. De middleware laat de Wagtail-beheeromgeving met rust, en laat alles met rust wat geen HTML-pagina is.
Vereisten
- Een Asyntai-account. Het gratis abonnement volstaat om te beginnen.
- Een Wagtail-site, versie 5.2 of nieuwer, met Django 4.2 of nieuwer en Python 3.9 of nieuwer.
- Toegang tot de code van die site, want u installeert een Python-pakket.
Installatie
Volg deze stappen om Asyntai aan uw Wagtail-site toe te voegen:
Installeer het pakket
Installeer het vanaf de Python Package Index, in dezelfde omgeving als uw site:
pip install wagtail-ai-chatbot
Zet het in uw instellingen
Zet de app en de Wagtail-instellingenmodule in INSTALLED_APPS, en de middleware boven aan MIDDLEWARE:
INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
Voer de migratie uit
Dit maakt de tabel die uw instellingen bewaart:
python manage.py migrate wagtail_asyntai
Plak uw widget-ID
Open in de Wagtail-beheeromgeving Settings en dan Asyntai chat assistant. Plak uw widget-ID en kies Save. U vindt het ID in uw Asyntai-dashboard onder Setup & Integration. U kunt het hele fragment plakken; het pakket bewaart alleen het ID.
Tip: Voeg je documenten, je vragen en antwoorden en je instructies toe in het Asyntai-dashboard voordat je publiceert, zodat de assistent al de eerste bezoeker goed beantwoordt.
Instellingen
- Widget-ID: de chat staat aan zolang hier een geldig ID staat, en uit als het veld leeg is.
- Chat alleen aan uitgelogde bezoekers tonen: ingelogde gebruikers zien de chat nooit. Handig als de assistent er is voor mensen die zich nog niet hebben aangemeld.
- Adres van het widgetscript: laat deze waarde staan, tenzij de ondersteuning van Asyntai u vraagt die te wijzigen.
De instellingen gelden per site, dus een project dat meerdere sites uit één Wagtail-installatie bedient, kan elke site een eigen assistent geven.
Instellingen in uw instellingenbestand
Een project dat de configuratie in omgevingsvariabelen bewaart, kan de beheeromgeving overslaan en de waarden in code zetten. Zijn beide gevuld, dan wint de beheeromgeving.
ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"
Drie andere waarden zijn optioneel: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL en ASYNTAI_SKIP_PREFIXES. De laatste noemt de paden die de widget nooit aanraakt, en die hebt u nodig als uw beheeromgeving niet op /admin/ staat.
De widget met de hand plaatsen
Wilt u de plek liever zelf kiezen, laat de middleware dan weg en zet de tag in uw basissjabloon. De tag en de middleware werken nooit allebei, dus u kunt beide houden.
{% load asyntai %} ... {% asyntai_widget %}
Wat de assistent kan
- Vragen van bezoekers meteen beantwoorden, dag en nacht, op elke pagina
- Antwoorden in meer dan 80 talen, automatisch herkend uit de vraag
- Open blijven terwijl de bezoeker van pagina naar pagina gaat
- Uw eigen geüploade documenten, veelgestelde vragen en instructies gebruiken voor nauwkeurige antwoorden
Privacy
Het pakket publiceert precies twee waarden op de pagina: het widget-ID en het adres van het script. Er gaat niets over uw pagina's of uw gebruikers naar Asyntai. Alleen de browser van de bezoeker praat met Asyntai, en alleen als de bezoeker de chat opent.
Abonnementen en prijzen
De Wagtail-integratie zit in alle Asyntai-abonnementen, ook in het gratis abonnement. Elk abonnement bevat een maandelijks aantal berichten dat u deelt over al uw kanalen en integraties. Prijzen bekijken.
Verwijderen
Maak het veld met het widget-ID leeg om de chat uit te zetten. Om het pakket te verwijderen, haalt u de middleware en de app uit uw instellingen en verwijdert u het met pip.
Broncode
Het pakket is vrij en opensource, onder de MIT-licentie. U kunt elke regel lezen op GitHub.
Hulp nodig?
Als u vragen heeft of problemen ondervindt, neem dan contact met ons op via [email protected].