Alle Dokumentationen anzeigen

Stella AI Chatbot: Installations- und Benutzerhandbuch

Stella KI-Chatbot für Websites und Kundensupport

Installations- und Benutzerhandbuch für Stella AI Chatbot mit FAQ-Automation, Lead-Erfassung, KI-Gesprächen, RAG, menschlicher Übergabe und Pro-Analysen.

Dieser Leitfaden deckt sowohl die Free- als auch die Pro-Edition an einem Ort ab. Wenn eine Funktion nur in Pro verfügbar ist, ist sie mit (Pro) markiert.

1. Installation

1.1 Voraussetzungen

  1. Node.js 18+ - Erforderliche Laufzeit zum Ausführen des Chatbot-Backend-Servers.
  2. npm - Erforderlich zur Installation der Projektabhängigkeiten.
  3. Moderner Browser - Erforderlich für Zugriff auf das Admin-Panel und Tests des Widget-Verhaltens.
  4. PostgreSQL 13+ (optional in Pro) - Nur erforderlich, wenn PostgreSQL-Speichermodus gewählt wird.
  5. pgvector (optional in Pro) - Erforderlich für PostgreSQL-Vektorähnlichkeitssuche im RAG-Modus.
  6. Ollama (optional in Pro) - Nur erforderlich, wenn lokale Embedding-Erzeugung ohne API-Kosten genutzt wird.

1.2 Herunterladen und vorbereiten

  1. Paket entpacken - Entpacke entweder stella-ai-chatbot-free oder stella-ai-chatbot-pro.
  2. Ordner im Terminal öffnen - Führe alle Installations-/Startbefehle aus diesem Verzeichnis aus.
  3. Abhängigkeiten installieren - Lädt alle erforderlichen Backend-Bibliotheken herunter.
npm install

1.3 Umgebung konfigurieren

  1. .env erstellen - Kopiere .env.example nach .env.
  2. Erforderliche Variablen setzen:
    • NODE_ENV - Definiert den Laufzeitmodus (development oder production).
    • APP_SECRET - Wird zum Signieren/Verifizieren sicherer Tokens und Sessions verwendet.
    • ADMIN_USER - Admin-Benutzername.
    • ADMIN_PASS - Admin-Passwort.
    • INSTALL_TOKEN - Schützt den Installer vor unbefugtem Zugriff.
    • CORS_ORIGINS / ALLOWED_ORIGINS - Steuert, welche Origins APIs aufrufen dürfen.
    • DATA_ENCRYPTION_KEY - Zur Verschlüsselung sensibler Daten (falls unterstützt).
  3. Optionale Variablen:
    • PORT - Server-Port (kann von der Plattform dynamisch überschrieben werden).
    • TRUST_PROXY=true - Aktiviert korrekte IP-Erkennung hinter Reverse Proxy/CDN.

1.4 Anwendung starten

npm start
  • /install - Ersteinrichtungsassistent.
  • /admin - Admin-Login und Dashboard.

1.5 Installationsschritte

  1. Installer öffnen - /install initialisiert das Chatbot-System.
  2. Installations-Token eingeben - Bestätigt autorisierte Installation.
  3. Speichermodus wählen:
    • Free: JSON-Speicher.
    • Pro: JSON oder PostgreSQL.
  4. Installation abschließen - Erstellt erforderliche Standardwerte/Einstellungen.
  5. install.lock erzeugt - Verhindert versehentliche Neuinstallation und liegt im data-Ordner.

1.6 Widget auf beliebiger Website einbinden

  1. Embed-Code-Bereich öffnen - Generiert Script für Frontend-Integration.
  2. Script kopieren - Enthält Widget-Loader und API-Basis-URL.
  3. Vor </body> einfügen - Stellt sicher, dass das Widget nach dem Seiteninhalt lädt.
  4. Seite aktualisieren - Prüft, ob Chatbot angezeigt wird und funktioniert.

1.7 Produktions-Checkliste

  1. HTTPS aktivieren - Schützt Datenverkehr und Zugangsdaten.
  2. Starke Secrets verwenden - Verhindert Kompromittierung von Token/Sessions.
  3. Domains einschränken - Verhindert Widget/API-Missbrauch auf nicht autorisierten Websites.
  4. Installer schützen - Blockiert öffentliche Neuinstallationsangriffe.
  5. CSRF-/Sicherheitskontrollen aktivieren - Schützt Admin-Schreibvorgänge.
  6. Aufbewahrungsrichtlinie setzen - Hält Logs verwaltbar und regelkonform.

2. Benutzerhandbuch (Schritt für Schritt)

2.1 Admin-Login

  1. /admin öffnen - Zugriff auf die Admin-Einstiegsseite.
  2. Anmelden - Verwendet Zugangsdaten aus .env.
  3. Menü nutzen - Overview, Settings, FAQs, Logs.

2.2 Overview-Seite

  1. Nutzungsstatistiken - Zeigt eine Zusammenfassung der Chatbot-Aktivität.
  2. Matched vs unmatched - Zeigt den Trend der Antwortqualität.
  3. Top matched keywords - Erkennt, welche Fragen erfolgreich beantwortet werden.
  4. Top unmatched questions - Zeigt FAQ/AI-Inhaltslücken zur Optimierung.

2.3 Settings-Seite

A. Core Identity

  1. Chatbot Name - Titel im Chat-Header.
  2. Avatar Upload - Markenbild in Launcher und Chat.
  3. Avatar Shape - Steuert, ob Avatar rund oder quadratisch erscheint.
  4. Show Live Preview - Aktiviert/deaktiviert Live-Vorschau im Admin.

B. Messaging & Engagement

  1. Welcome Message - Nachricht beim Öffnen der Chatbox.
  2. No Match Message - Fallback-Antwort, wenn keine passende Antwort gefunden wird.
  3. Fuzzy Match - Findet ähnliche Schlüsselwörter/Fragen auch ohne exakte Übereinstimmung.
  4. Fuzzy Threshold - Legt die Strenge des Fuzzy Matching fest.
  5. Lead Capture - Erfasst Name/E-Mail vor oder während des Chats.
  6. Lead Capture Prompt - Nachricht zur Abfrage von Besucherdaten.

C. Widget Appearance

  1. Widget Position - Platziert den Launcher links oder rechts.
  2. Widget Size - Steuert die visuelle Größe des Launchers.
  3. Brand/Theme Colors - Passt das Widget an das Branding der Website an.
  4. Avatar Size - Steuert die Avatargröße in der Chat-UI.
  5. Animation - Fügt Effekte wie pulse/shake/float hinzu.
  6. Chatbox Width/Height - Steuert die Größe des Gesprächspanels.

D. System & Performance

  1. Items Per Page - Seitengröße der Admin-Tabellen.
  2. Log Retention Days - Anzahl Tage bis zur Log-Bereinigung.
  3. Auto Cleanup - Löscht alte Daten automatisch nach Aufbewahrungsregel.
  4. Enforce HTTPS - Blockiert unsichere Nicht-HTTPS-Anfragen (außer localhost).
  5. Enforce Admin CSRF - Erfordert CSRF-Token für Admin-Schreibvorgänge.

E. Categories

  1. Add Category - Erstellt neue Gruppen für FAQ/Chat-Flows.
  2. Recommended Categories - Bis zu 3 Kategorien werden zuerst im Widget angezeigt.
  3. Delete Category - Entfernt ungenutzte Kategorie (oder Merge/Neuzuweisungslogik greift).

F. Embed Code

  1. API Base URL - Definiert die Backend-URL des Widget-Scripts.
  2. Allowed Widget Domains - Beschränkt, wo das Widget ausgeführt werden darf.
  3. Widget Domain Policy - restricted erzwingt Liste erlaubter Domains.
  4. Regenerate / Copy Code - Erneuert und kopiert den Embed-Code.

2.4 Pro-Funktionen in Settings (Pro)

A. Human Handoff (Pro)

  1. Enable Handoff - Aktiviert Eskalation an menschlichen Support.
  2. Escalate After Unmatched - Anzahl fehlgeschlagener Matches bis zur Eskalation.
  3. Handoff Message - Nachricht bei ausgelöster Eskalation.
  4. Support URL - Link zur Kontaktaufnahme mit menschlichem Support.
  5. Business Hours - Optionales Zeitfenster für Handoff-Verhalten.

B. AI Powered Responses (Pro)

  1. AI Provider - Wählt den LLM-Backend-Anbieter.
  2. API Key - Authentifizierungsschlüssel des Anbieters.
  3. Load Models - Lädt verfügbare Modelle für Anbieter/Key.
  4. AI Model - Modell zur Antwortgenerierung.
  5. Test Connection - Prüft Anbieter-/Modell-/Key-Konfiguration.
  6. Max Tokens - Maximale Ausgabelänge der AI-Antwort.
  7. System Instructions - Definiert Verhalten, Ton und Regeln des Bots.
  8. AI Disclaimer - Optionaler Hinweistext unter AI-Antworten.

C. Vector Retrieval (RAG) (Pro)

  1. Enable RAG - Aktiviert Retrieval aus indexierten Website-Inhalten.
  2. Use PostgreSQL pgvector - Aktiviert skalierbare Vektorspeicherung/-suche.
  3. Embedding Provider - Dienst zur Umwandlung von Text in Vektoren.
  4. Embedding API Key - Authentifizierung für Embedding-Anbieter.
  5. Fetch Models - Lädt verfügbare Embedding-Modelle.
  6. Embedding Model - Modell für Indexierung und Query-Embeddings.
  7. Test Embedding Connection - Prüft Embedding-Endpunkt.
  8. Crawl Root URL / Sitemap - Definiert Startpunkte des Crawlings.
  9. Max Pages / Max Depth - Steuert Umfang und Tiefe des Crawlings.
  10. Chunk Size / Overlap - Steuert Textsegmentierung für bessere Retrieval-Qualität.
  11. Include / Exclude Patterns - Feinkontrolle über zu crawlende URLs.
  12. Resume Mode - Überspringt bereits indexierte URLs beim Recrawl.
  13. Crawl Website Content - Startet den Indexierungsjob.
  14. RAG Ranking Mode - Steuert Ranking-Strategie (Balanced / Exact Product First).

2.5 FAQs-Seite

  1. Add FAQ - Manuelle Q&A-Erstellung mit eindeutigem Keyword.
  2. Edit/Delete FAQ - Pflege und Korrektur bestehender Antworten.
  3. Import File - Massenimport aus TXT/CSV/CSB/DOCX.
  4. Delimiter Option - Parst benutzerdefinierte Dateiformate (:, ,, | usw.).
  5. Duplicate Keyword Handling - Überspringen oder Suffix bei Duplikaten.
  6. Category Handling - Fehlende Kategorien erstellen oder Fallback-Kategorie verwenden.
  7. Import Summary - Zeigt Anzahl hinzugefügt/abgelehnt/dupliziert.

2.6 Logs-Seite

  1. Session Filters - Suche nach Session-Key, Name oder E-Mail.
  2. Show Chat - Öffnet Chatverlauf nur der ausgewählten Session.
  3. Leads Table - Zeigt erfasste Besucherkontaktdaten.
  4. Pagination - Effiziente Navigation großer Datenmengen mit oberen/unteren Kontrollen.

2.7 Frontend-Verhalten

  1. Widget Open - Nutzer öffnet Launcher und startet Chat.
  2. Welcome/Categories - Einleitung und Empfehlungen erscheinen (wenn aktiviert).
  3. User Query Handling:
    • Free: FAQ + Fuzzy-Match-Flow.
    • Pro: FAQ + AI + RAG + Handoff-Regeln.
  4. Lead Collection - Name/E-Mail-Formular erscheint, wenn aktiviert.
  5. Logging - Sessions/Nachrichten/Leads werden für Analytics gespeichert.

2.8 Fehlerbehebung

  1. Widget nicht sichtbar - Embed-Code, Domain-Policy und Browserkonsole prüfen.
  2. Kurze AI-Antworten - Anderes Modell/Anbieter testen, max tokens erhöhen, Provider-Metadaten prüfen.
  3. RAG antwortet nicht - Crawl-Erfolg, Embedding-Konfiguration und Ranking-Modus prüfen.
  4. Installation blockiert - Install-Token und Lock/Maintenance-Verhalten prüfen.

2.9 Empfohlener Rollout-Pfad

  1. Mit FAQ + Kategorien starten - Zuverlässige Basisantworten aufbauen.
  2. Fuzzy Match aktivieren - Toleranz für variierende Fragen erhöhen.
  3. Lead Capture aktivieren - Qualifizierte Kontakte erfassen.
  4. (Pro) AI aktivieren - Breitere natürlichsprachliche Anfragen abdecken.
  5. (Pro) RAG aktivieren - Antworten auf eigene Website-Inhalte stützen.
  6. (Pro) Handoff aktivieren - Komplexe Anliegen an Menschen eskalieren.
  7. Sicherheit finalisieren + deployen - Richtlinien fixieren und produktiv gehen.