WordPress
Plugin hochladen, Schlüssel hinterlegen, Beiträge über die Sitemap trainieren, Chat per Schalter, Block oder Shortcode anzeigen.
- WordPress 6.2+, PHP 7.4+
- Training beim Veröffentlichen per WP-Cron
- Fehlersuche für Sitemap, Cron und Proxy
Anleitungen
Beide Systeme nutzen dasselbe Konto, dieselbe API und dieselbe Wissensbasis. Wähle Dein CMS, der Rest ist Schritt für Schritt erklärt, inklusive Fehlersuche und Datenschutz-Hinweisen.
Plugin hochladen, Schlüssel hinterlegen, Beiträge über die Sitemap trainieren, Chat per Schalter, Block oder Shortcode anzeigen.
Per Contao Manager oder Composer installieren, im Assistenten „Erste Schritte“ verbinden, trainieren und den Chat auf allen Seiten anzeigen.
Grundlagen
Du registrierst Dich einmal im Portal. Jede Website bekommt ein eigenes Projekt, das ist die Datengrenze: Inhalte, Vektoren und Schlüssel gehören immer genau einem Projekt.
Der Schlüssel ordnet jede Anfrage Deinem Projekt zu. Er steht nur in Deinem CMS auf dem Server und wird nie an den Browser geschickt. Behandle ihn wie ein Passwort.
Begrenzt wird nur das Erzeugen von Antworten: je Minute und je Kalendermonat. Die Zahlen kommen zur Laufzeit von der API und stehen in der Übersicht Deiner Erweiterung.
Die Spracheingabe funktioniert nur über HTTPS (oder localhost) und in Browsern mit MediaRecorder. Ohne diese Voraussetzungen bleibt das Mikrofon einfach verborgen.
Datenschutz-Fragen beantwortet die Seite DSGVO & AVV. Dort findest Du auch die Checkliste für Betreiber.
Für Entwickler
Die API ist öffentlich dokumentiert. Mit einem API-Schlüssel stellst Du Fragen aus Deinem eigenen Backend. Rufe sie nie aus dem Browser auf, sonst liegt der Schlüssel offen.
| Route | Antwortart |
|---|---|
POST …/chatbot-ai/generate/chat | Chat: kurz und schnell, höchstens drei Sätze |
POST …/chatbot-ai/generate/chatbot | Suche: ausführlich, mit Quellenangabe |
Beide gibt es auch als Stream (Server-Sent Events): zuerst ein Ereignis mit den Quellen, danach die Antwort in Stücken, zum Schluss ein end-Ereignis. Hinter einem Reverse Proxy muss das Puffern abgeschaltet sein.
Beispielcurl -X POST https://api.chatbot.bluebranch.de/api/v1/chatbot-ai/generate/chat \
-H "x-api-key: DEIN_API_SCHLUESSEL" \
-H "Content-Type: application/json" \
-d '{"prompt": "Wie erreiche ich euch?", "language": "deutsch"}'
Verbindlich sind die Routen und Felder der API-Dokumentation. Die Nutzlast (prompt, language, chat_context, max_tokens) ist bei beiden Antwortarten gleich.
Jetzt starten
Registrieren, API-Schlüssel erzeugen, Erweiterung installieren: Die kostenlose Stufe genügt zum Ausprobieren. Den AVV nach Art. 28 DSGVO schicken wir Dir auf Anfrage.