Wagtail-Integration
Ein KI-Assistent, der Fragen auf Ihrer Wagtail-Website beantwortet
Übersicht
Das Wagtail-Paket setzt einen KI-Assistenten auf Ihre Website. Ein Chat-Button sitzt in der Ecke jeder Seite, Besucher stellen ihre Frage in eigenen Worten, und die Antwort kommt aus Ihren eigenen Inhalten: Ihrer Website, Ihren hochgeladenen Dokumenten und Ihren Hilfe-Artikeln.
KI-Hinweis: Antworten auf Ihrer Website stammen von einer KI. Sie können manchmal falsch oder unvollständig sein. Prüfen Sie sie, bevor Sie sich darauf verlassen, besonders bei wichtigen Entscheidungen.
So funktioniert es
Das Paket fügt eine Middleware hinzu, die ein kleines Skript direkt vor das schließende body-Tag jeder Seite setzt. Das Skript wartet, bis die Seite fertig geladen ist, und holt dann das Chat-Widget von Asyntai. So wird Ihre Website zuerst gezeichnet und die Ladezeit bleibt gleich. Ihr Server spricht nie mit Asyntai, nur der Browser des Besuchers.
Sie ändern nichts in Ihren Templates. Die Middleware lässt die Wagtail-Verwaltung unberührt, und sie lässt alles unberührt, was keine HTML-Seite ist.
Voraussetzungen
- Ein Asyntai-Konto. Der kostenlose Tarif genügt für den Anfang.
- Eine Wagtail-Website, Version 5.2 oder neuer, mit Django 4.2 oder neuer und Python 3.9 oder neuer.
- Zugang zum Code dieser Website, denn Sie installieren ein Python-Paket.
Installation
Führen Sie diese Schritte aus, um Asyntai auf Ihrer Wagtail-Website einzubauen:
Paket installieren
Installieren Sie es aus dem Python Package Index, in derselben Umgebung wie Ihre Website:
pip install wagtail-ai-chatbot
In die Einstellungen eintragen
Tragen Sie die App und das Wagtail-Einstellungsmodul in INSTALLED_APPS ein und die Middleware an den Anfang von MIDDLEWARE:
INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
Migration ausführen
Das legt die Tabelle an, die Ihre Einstellungen hält:
python manage.py migrate wagtail_asyntai
Fügen Sie Ihre Widget-ID ein
Öffnen Sie in der Wagtail-Verwaltung Einstellungen und dann Asyntai chat assistant. Fügen Sie Ihre Widget-ID ein und wählen Sie Speichern. Die ID finden Sie in Ihrem Asyntai Dashboard unter Setup & Integration. Sie können das ganze Snippet einfügen; das Paket behält nur die ID.
Tipp: Fügen Sie Ihre Dokumente, Ihre Fragen und Antworten und Ihre Anweisungen im Asyntai-Dashboard hinzu, bevor Sie veröffentlichen, damit der Assistent schon den ersten Besucher richtig beantwortet.
Einstellungen
- Widget-ID: Der Chat ist an, solange hier eine gültige ID steht, und aus, wenn das Feld leer ist.
- Chat nur abgemeldeten Besuchern zeigen: Angemeldete Nutzer sehen den Chat nie. Nützlich, wenn der Assistent für Leute da ist, die sich noch nicht angemeldet haben.
- Adresse des Widget-Skripts: Lassen Sie diesen Wert unverändert, außer der Asyntai-Support bittet Sie darum.
Die Einstellungen gelten je Website. Ein Projekt, das mehrere Websites aus einer Wagtail-Installation ausliefert, kann jeder Website einen eigenen Assistenten geben.
Einstellungen in Ihrer Einstellungsdatei
Ein Projekt, das seine Konfiguration in Umgebungsvariablen hält, kann die Verwaltung überspringen und die Werte im Code setzen. Sind beide gefüllt, gewinnt die Verwaltung.
ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"
Drei weitere Werte sind freiwillig: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY, ASYNTAI_SCRIPT_URL und ASYNTAI_SKIP_PREFIXES. Der letzte nennt die Pfade, die das Widget nie anfasst. Den brauchen Sie, wenn Ihre Verwaltung nicht unter /admin/ liegt.
Das Widget von Hand platzieren
Wenn Sie die Stelle lieber selbst wählen, lassen Sie die Middleware weg und setzen Sie stattdessen das Tag in Ihr Basis-Template. Tag und Middleware greifen nie beide, deshalb können Sie beide behalten.
{% load asyntai %} ... {% asyntai_widget %}
Was der Assistent kann
- Besucherfragen sofort beantworten, rund um die Uhr, auf jeder Seite
- In mehr als 80 Sprachen antworten, automatisch anhand der Frage erkannt
- Offen bleiben, während der Besucher von Seite zu Seite geht
- Ihre eigenen hochgeladenen Dokumente, FAQs und Anweisungen für genaue Antworten nutzen
Datenschutz
Das Paket veröffentlicht genau zwei Werte auf der Seite: die Widget-ID und die Skript-Adresse. Nichts über Ihre Seiten oder Ihre Nutzer geht an Asyntai. Nur der Browser des Besuchers spricht mit Asyntai, und nur wenn der Besucher den Chat öffnet.
Tarife und Preise
Die Wagtail-Integration ist in allen Asyntai-Tarifen enthalten, auch im kostenlosen. Jeder Tarif enthält ein monatliches Nachrichtenkontingent, das für alle Ihre Kanäle und Integrationen zusammen gilt. Preise ansehen.
Deinstallation
Leeren Sie das Feld mit der Widget-ID, um den Chat abzuschalten. Um das Paket zu entfernen, nehmen Sie die Middleware und die App aus Ihren Einstellungen und deinstallieren Sie es mit pip.
Quellcode
Das Paket ist frei und quelloffen, unter der MIT-Lizenz. Sie können jede Zeile auf GitHub lesen.
Brauchen Sie Hilfe?
Wenn Sie Fragen haben oder auf Probleme stoßen, kontaktieren Sie uns unter [email protected].