RagChat

RagChat ist ein Chat für Ihre Website, der Fragen Ihrer Besucher aus Ihrer eigenen Wissensbasis beantwortet. Sie legen fest, woraus der Chat antworten darf: aus Texten, Dateien, Webseiten und Ihrem Produktkatalog. Findet er dort nichts, erfindet er nichts, sondern zeigt Ihren Hinweistext, zum Beispiel wie man Sie erreicht, oder übergibt an einen Menschen. Zu jeder Antwort nennt er die Quellen.

Der Chat merkt sich das Gespräch eines Besuchers für eine Weile (die letzten vier Fragen der vergangenen zwei Stunden). Antwortet der Besucher auf eine Rückfrage nur kurz, etwa mit „Dezentral“, versteht der Chat das als Antwort auf seine Frage und bleibt beim Thema. Findet er zweimal hintereinander nichts, wiederholt er Ihren Hinweistext nicht, sondern sagt kurz, dass er dazu nichts Genaueres weiß, und bietet einmal ein persönliches Gespräch an. In einem neuen Browserfenster oder nach zwei Stunden beginnt das Gespräch von vorn.

Sie können mehrere Bots anlegen, etwa einen Support-Chat für die Hilfeseiten und einen Produktberater für die Preisseite. Jeder Bot hat seine eigene Wissensbasis, seine eigenen Texte und seine eigenen Websites.

In den Videos

Die erfundene Lindenquell Haustechnik zeigt am echten Bildschirm, wofür diese Funktion im Alltag gut ist. Mit Untertiteln, je drei bis fünf Minuten.

Voraussetzungen und Rechte

Schritt für Schritt: vom leeren Modul zum ersten Bot

  1. Öffnen Sie RagChat. Die Seite hat die Reiter Dashboard, Bots, Wissensbasis, Gespräche und Einstellungen.
  2. Legen Sie im Reiter Wissensbasis mit Neue Wissensbasis eine öffentliche Basis an und fügen Sie Quellen hinzu (siehe unten).
  3. Legen Sie im Reiter Bots mit Neuer Bot einen Bot an: Name, Art, Wissensbasis und die Websites, die ihn einbinden dürfen.
  4. Prüfen Sie ihn mit Vorschau. Fragen, die Sie dort stellen, beantwortet der KI-Dienst wirklich; sie stehen im Gesprächsprotokoll und zählen zu den Kosten.
  5. Kopieren Sie mit Einbindungscode die Zeile in Ihre Website (siehe unten).

Dashboard

RagChat Dashboard mit den Kennzahlen Fragen in 24 Stunden, 7 und 30 Tagen, durchschnittlicher Antwortzeit, Fragen ohne Antwort und Hilfreich zu nicht hilfreich, darunter dem Zustand der Wissensbasen
Das Dashboard: Kennzahlen und Zustand jeder Wissensbasis

Das Dashboard zeigt, wie viele Fragen in den letzten 24 Stunden, 7 und 30 Tagen gestellt wurden, wie schnell der Chat antwortet und wie viele Fragen ohne Antwort blieben. Darunter steht der Zustand jeder Wissensbasis, die Nutzung des KI-Dienstes im Monat mit den geschätzten Kosten und eine Liste der Fragen, auf die der Chat keine Antwort fand. Ergänzen Sie in der Wissensbasis, was dort fehlt, dann werden diese Fragen beim nächsten Mal beantwortet.

Der Zustand einer Wissensbasis kommt von einer Prüffrage: Sie nennen eine Frage und die Quelle, die sie beantworten muss. Beim Speichern wird sie sofort gestellt, danach nach jeder Änderung der Basis erneut. Kommt die Quelle nicht mehr zurück, zeigt die Basis „Prüffrage nicht gefunden“, bevor ein Besucher es bemerkt. Jetzt prüfen stößt die Prüfung von Hand an.

Wissensbasis

Eine Wissensbasis ist das, was ein Bot weiß. Sie ist öffentlich (Bots auf Ihrer Website dürfen daraus antworten) oder intern (nur Funktionen in Octoserv, zum Beispiel das Handbuch oder die Support-KI, nie eine Website). Eine Basis, die ein Bot nutzt, kann nicht auf intern gestellt werden.

Reiter Wissensbasis mit der Auswahl Hilfe und häufige Fragen, den Knöpfen Bearbeiten, Index neu aufbauen und Löschen und den Quellen Text, Datei und Webadresse mit Status Eingelesen
Wissensbasis und Quellen: Text, Datei und Webadresse

Quellen fügen Sie auf drei Wegen hinzu:

Ein Text oder eine Datei ist in der Regel in Sekunden eingelesen, eine Webadresse innerhalb einer Minute. Einen Text ändern Sie mit Bearbeiten: Der gespeicherte Text öffnet sich, nach dem Speichern wird er neu eingelesen und ersetzt seine alten Textstellen. Mit Neu einlesen ersetzt eine Quelle ihre alten Textstellen in einem Schritt; geht dabei etwas schief, bleibt der alte Stand erhalten. Löschen Sie eine Quelle, verschwinden ihre Textstellen sofort aus der Basis. Webadressen können nach einer Anzahl Tagen automatisch neu gelesen werden (Einstellungen, 0 heißt nur auf Anfrage).

Produktkatalog als Quelle

Für den Produktberater schalten Sie Produktkatalog als Quelle dieser Basis nutzen ein. Octoserv liest dann Name, Nummer, Gruppe, Preis und Beschreibungen Ihrer aktiven Produkte. Ändern, deaktivieren oder löschen Sie ein Produkt, ist der Chat innerhalb einer Minute auf dem neuen Stand. Interne Notizen eines Produkts kommen nie in den Index. Mit einem Link wie https://shop.example.com/produkt/{code} nennt der Chat zu jedem Produkt eine Quelle zum Anklicken.

Anderes Modell gewählt?

Wechseln Sie unter Einstellungen › KI das Modell für die Suche nach Bedeutung, passen alte und neue Zahlenreihen nicht zusammen; Octoserv mischt sie nie. Die Quelle zeigt dann „Fehlgeschlagen“. Öffnen Sie die Basis und wählen Sie Index neu aufbauen: Der Index wird geleert und jede Quelle mit dem neuen Modell neu eingelesen.

Bots

Reiter Bots mit den Bots Website-Support und Produktberater, jeweils mit den Knöpfen Einbindungscode, Vorschau, Bearbeiten und Löschen
Die Liste der Bots

Ein Bot hat einen Namen (nur Sie sehen ihn), eine Wissensbasis, die Art (Support-Chat oder Produktberater), seine Texte und die Websites, die ihn einbinden dürfen. Andere Websites können den Chat weder anzeigen noch aufrufen.

Dialog Bot bearbeiten mit Name, Art, Wissensbasis, dem Feld Websites, die den Bot einbinden dürfen, Titel, Hinweis im Eingabefeld und Begrüßung
Ein Bot bearbeiten

Einbindung auf Ihrer Website

Sie binden einen Bot mit einer einzigen Zeile ein. Sie brauchen keine Erweiterung und keine Datei auf Ihrem Server. Den fertigen Code zeigt der Knopf Einbindungscode beim Bot. Alles, was der Besucher sieht, kommt von Ihrer Octoserv-Adresse. Ein Dienst Dritter kommt nur mit dem Schutz vor Bots hinzu: das Captcha, das Sie für Ihre Formulare gewählt haben.

Geöffnetes Chat-Fenster auf einer Website mit Begrüßung, Frage nach den Öffnungszeiten, Antwort mit Quelle und den Knöpfen Hilfreich und Nicht hilfreich, darunter der runde Chat-Knopf
Das Chat-Fenster auf der Website: Antwort mit Quelle und Bewertung

Chat-Knopf auf jeder Seite

Fügen Sie den Code vor dem schließenden Body-Tag der Seiten ein, die den Chat zeigen sollen:

<script src="https://IHRE-ADRESSE/embed/ragchat/BOT-ID.js" async></script>

Der Besucher sieht einen runden Knopf in der Ecke (Farbe und Seite stellen Sie beim Bot ein). Erst wenn er ihn anklickt, wird der Chat geladen; vorher geht keine Anfrage an Ihren Server außer der des kleinen Skripts selbst. Mit der Taste Esc schließt er den Chat wieder. Auf dem Telefon füllt der Chat den Bildschirm.

Mitten in einer Seite (Produktberater)

<div id="ragchat-advisor"></div>
<script src="https://IHRE-ADRESSE/embed/ragchat/BOT-ID.js" data-mode="advisor" data-target="#ragchat-advisor" async></script>

Der Chat erscheint dann an der Stelle des Elements, ohne Knopf. Das eignet sich für Beratungsseiten und Landingpages.

Bot, Chat und WhatsApp in einem Fenster

Haben Sie das Chat-Widget von Octoserv auf der Website, brauchen Sie für den Bot keinen zweiten Einbau-Code. Wählen Sie den Bot unter Einstellungen › LiveChat in der Karte Bot im Chat-Fenster. Dann gibt es nur einen Knopf und ein Fenster. Der Bot antwortet zuerst, Mit einem Menschen sprechen und Per WhatsApp bleiben unter dem Eingabefeld sichtbar, und bei einer Übergabe geht der Verlauf mit. Der eigene Knopf des Bots ist auf dieser Seite dann nicht nötig; wer beides eingebaut hat, nimmt ihn ab. Der Produktberater mitten in der Seite bleibt, wie er ist; steht auf der Seite das Chat-Widget, hat er zusätzlich den Knopf Mit einem Menschen sprechen, der das Chat-Fenster öffnet. Mehr dazu unter Chatbot mit Übergabe und Chat.

Erlaubte Websites

Beim Bot tragen Sie die Websites ein, die ihn einbinden dürfen, eine Adresse pro Zeile (zum Beispiel https://www.example.com, ohne Pfad). Der Server prüft bei jeder Frage, von welcher Seite sie kommt; andere Websites bekommen keine Antwort und können den Chat auch nicht in einem Rahmen anzeigen. Eine Adresse gilt genau so, wie Sie sie eintragen: www.example.com und example.com sind zwei Einträge. Schalten Sie einen Bot aus oder löschen Sie ihn, hört jeder verteilte Code sofort auf zu arbeiten. Hat Ihre Website eine Content-Security-Policy, muss sie Ihre Octoserv-Adresse für script-src und frame-src erlauben.

Besucher einem Kontakt zuordnen

Standardmäßig bleibt jeder Besucher anonym. Kennt Ihre Seite den Besucher, etwa weil er über einen persönlichen Link aus einer Mail oder einem Formular kam, kann sie dem Chat den signierten Kontaktlink übergeben, auf drei Wegen:

Eine Kontakt-ID genügt nie; nur ein von Octoserv signierter und noch gültiger Link ordnet zu. Die Fragen stehen dann im Journal des Kontakts als „RagChat: Frage“.

Barrierefreiheit

Der Chat ist mit der Tastatur bedienbar (Enter sendet, Umschalt+Enter macht eine neue Zeile, Esc schließt), die Antworten werden Screenreadern vorgelesen, die Kontraste erfüllen WCAG AA, und er folgt der hellen oder dunklen Einstellung des Geräts.

Gespräche

Reiter Gespräche mit Filtern nach Bot, Treffer, Markierung, Bewertung und Zeitraum und einer Liste von Fragen mit Antwort, Treffer-Abzeichen und Bewertung
Das Gesprächsprotokoll mit Filtern

Jede Frage an einen Bot steht hier mit Antwort, Quellen, Antwortzeit und der Bewertung des Besuchers („Hilfreich“, „Nicht hilfreich“). Markiert sind Fragen ohne Antwort, verdächtige Fragen und Fragen, bei denen der KI-Dienst nicht geantwortet hat. Mit Details sehen Sie die ganze Antwort mit ihren Quellen.

Verdächtige Fragen sind Angriffe (Skripte, Datenbankbefehle) und Versuche, den Bot umzuprogrammieren („Ignoriere alle Anweisungen“). Sie werden nicht an das Modell geschickt; der Besucher sieht Ihren Hinweistext, und Sie bekommen eine Meldung.

Einstellungen

Reiter Einstellungen mit den Karten Schutz vor Überlastung, Gesprächsprotokoll und Hinweise an die Mitarbeiter
Die RagChat-Einstellungen

Schutz vor Bots

Jede Antwort des Chats ist eine Anfrage an den KI-Dienst und kostet Geld. Damit kein Skript den Chat in großer Zahl befragt, prüft der Chat vor der ersten Frage eines Besuchers einmal, ob ein Mensch fragt. Er nutzt dafür das Captcha Ihrer öffentlichen Formulare: Cloudflare Turnstile, Google reCAPTCHA, hCaptcha oder Friendly Captcha. Eingerichtet wird es unter Einstellungen › Anmeldung und Formulare auf der Karte Captcha für Formulare (Websiteschlüssel dort, geheimer Schlüssel unter API-Schlüssel). Ein eigenes Captcha nur für den Chat gibt es nicht; ein Anbieter schützt Formulare und Chat zugleich.

Übergabe an einen Menschen

Wenn der Bot nicht weiterweiß, lässt er den Besucher nicht allein. Er bietet einen Menschen an, sobald er in der Wissensbasis nichts findet oder der Besucher darum bittet. Ist jemand erreichbar, beginnt das Gespräch sofort im Chat mit dem bisherigen Verlauf. Sonst hinterlässt der Besucher Name und E-Mail oder Telefon mit Datenschutzhaken, und es entsteht ein wartendes Gespräch. Das ganze Verfahren mit Beispiel steht auf der Seite Chatbot mit Übergabe. Auf WhatsApp antwortet noch kein Bot, deshalb gibt es dort keine Übergabe.

Datenschutz

Zusammenspiel mit anderen Funktionen

Häufige Fragen

FrageAntwort
Der Chat antwortet nicht.Prüfen Sie im Dashboard, ob der KI-Dienst eine Warnung zeigt (Anbieter außerhalb der EU), ob der Bot aktiv ist und ob die Website bei Websites, die den Bot einbinden dürfen genau so steht, wie sie im Browser erscheint.
Der Chat sagt zu oft „nichts gefunden“.Ergänzen Sie die Wissensbasis um die Fragen aus der Liste auf dem Dashboard oder senken Sie den Mindest-Treffer des Bots.
Werden Kundendaten gespeichert?Fragen und Antworten für die eingestellte Zeit (vorgegeben 90 Tage). Ohne Haken bei Text von Fragen und Antworten speichern nur Zahlen.