Anleitung — Futonwerk Chatbot V2

Was ist das hier?

Dieses Portal verwaltet den Chatbot für futonwerk.eu. Hier steuern Sie, was der Chatbot weiß, wie er antwortet und welchen Stil er hat. Je besser die Daten hier gepflegt sind, desto besser berät der Chatbot die Kunden.

Die Wissensdaten stammen von futonwerk.de und wurden automatisch in Markdown umgewandelt. Die Produkte werden auf futonwerk.eu (Shopify) verkauft.

Die 6 Tabs

• Direkte Antworten (218 FAQs) — Frage-Antwort-Paare. Wenn eine Kundenfrage nah genug an einer FAQ ist, wird die Antwort sofort zurückgegeben — ohne KI. Das ist der schnellste und zuverlässigste Weg. Hier können Sie Fragen und Antworten bearbeiten, löschen oder durchsuchen.
• Wissensdatenbank (41 Dateien) — Markdown-Dateien, je eine pro Seite von futonwerk.de. Der Chatbot durchsucht diese per Vektordatenbank und formuliert mit KI eine Antwort. Hier können Sie Texte prüfen, korrigieren und löschen.
• Prüfbericht — Automatische Prüfung auf Widersprüche zwischen den Wissensdatenbank-Texten (z.B. verschiedene Gewichtsangaben für dasselbe Produkt) und Abgleich mit der Produktdatenbank.
• Historie — Versionsverlauf jeder Datei. Bei jedem Speichern wird automatisch ein Backup angelegt. Alte Versionen können angesehen und wiederhergestellt werden.
• Prompts (nur Admin) — Die internen Anweisungen, die das Verhalten des Chatbots steuern. Es gibt 4 Prompts:
  • system_prompt.txt — Grundregeln: Persönlichkeit, keine Preise, keine Halluzinationen, Formatierung. Wird bei JEDER Anfrage mitgesendet.
  • product_prompt.txt — Zusatzregeln für Produktfragen: exakte Namen, Gewichtslimits, max 3 Empfehlungen.
  • knowledge_prompt.txt — Zusatzregeln für Wissensfragen: nur aus Kontext antworten, zusammenfassen.
  • consultation_prompt.txt — Zusatzregeln für Beratung: 3-Schritte-Funnel (Schlafposition → Gewicht → Einsatzort).
• Anleitung — Diese Seite.

Wie der Chatbot antwortet

Bei jeder Kundenfrage durchläuft der Chatbot diese Reihenfolge:

1. Beratung aktiv? — Wenn der Kunde gerade in einer persönlichen Beratung ist (Schlafposition, Gewicht, Einsatzort), wird die Antwort direkt im Funnel verarbeitet.
2. Nicht-existierendes Produkt? — Wenn der Kunde ein Produkt nennt, das es nicht gibt (z.B. "DX6"), sagt der Bot das ehrlich.
3. FAQ-Treffer? — Die Frage wird gegen 218 FAQ-Paare geprüft. Bei gutem Match → direkte Antwort ohne KI (schnellster Weg).
4. Intent-Erkennung — Das LLM klassifiziert die Frage: Produkt, Wissen, Beratung oder Offtopic.
5. Antwort generieren — Je nach Intent werden die passenden Daten (Produktdatenbank, ChromaDB, Beratungsfunnel) geladen und das LLM formuliert eine Antwort.

Wissensdatenbank bearbeiten

1. Wechseln Sie zum Tab "Wissensdatenbank"
2. Klicken Sie links auf eine Datei
3. Bearbeiten Sie den Text im Editor (Markdown-Format)
4. Klicken Sie "Speichern" (oder Cmd+S / Strg+S) — der Button wird kurz grün
5. Klicken Sie "Neu laden" um alle Änderungen in die Chatbot-Datenbank (ChromaDB) zu übernehmen

Hinweis: Das Speichern ändert nur die Datei. Erst "Neu laden" macht die Änderung im Chatbot aktiv. Bei jedem Speichern wird automatisch ein Backup angelegt (sichtbar im Tab "Historie").

FAQs bearbeiten

1. Wechseln Sie zum Tab "Direkte Antworten"
2. Suchen Sie eine FAQ über die Suchleiste
3. Klicken Sie "Bearbeiten" um Frage oder Antwort anzupassen
4. Klicken Sie "Speichern" — die Änderung ist sofort im Chatbot aktiv

Hinweis: FAQ-Änderungen werden sofort aktiv (kein "Neu laden" nötig). Beim nächsten Chat wird der FAQ-Cache automatisch neu aufgebaut.

Prompts bearbeiten (nur Admin)

1. Wechseln Sie zum Tab "Prompts"
2. Klicken Sie links auf eine Prompt-Datei
3. Bearbeiten Sie den Text — Platzhalter wie {shop_name} werden automatisch ersetzt
4. Klicken Sie "Speichern"

Hinweis: Prompt-Änderungen werden erst nach einem Docker-Neustart aktiv, weil die Prompts beim Start in den Speicher geladen werden.

Mehrsprachigkeit

Der Chatbot erkennt automatisch die Sprache des Kunden und antwortet in derselben Sprache. 10 Sprachen werden unterstützt: Deutsch, Englisch, Französisch, Italienisch, Spanisch, Niederländisch, Polnisch, Tschechisch, Dänisch und Schwedisch. Wenn der Kunde mitten im Gespräch die Sprache wechselt, wechselt der Bot automatisch mit.

Wichtige Regeln

• Keine Preise — Der Chatbot nennt niemals Preise. Verweist auf die Produktseite.
• Keine Rabatte — Keine Gutscheine, Sonderaktionen oder Rabattcodes.
• Keine Halluzinationen — Der Bot erfindet keine Produkte und keine Fakten.
• Produkt-URLs — Müssen auf futonwerk.eu zeigen (Shopify-Shop), nicht futonwerk.de.
• Kontakt — Bei Fragen die der Bot nicht beantworten kann: mail@futonwerk.de, +49 (0) 231 5898 112 0