Zum Hauptinhalt springen

Erste Schritte

Willkommen zur Dokumentation der Bot-Plattform! Dieser Leitfaden hilft Ihnen zu verstehen, wie Sie intelligente, konversationelle Bots mit unserer Plattform erstellen, konfigurieren und bereitstellen können.

Dokumentationsstruktur​

Unsere Dokumentation ist in die folgenden Hauptbereiche unterteilt, um Sie durch alle Aspekte der Bot-Entwicklung zu führen:

Bot-Verwaltung​

Konfigurieren und verwalten Sie Ihre Bot-Instanzen, einschließlich:

  • Einstellungen - Passen Sie den Bot-Namen, die Beschreibung, visuelle Tags (DEV/STAGING/PROD) an und definieren Sie die Persönlichkeit Ihres Bots
  • Anbieter - Konfigurieren Sie KI-Anbieter (OpenAI, Azure, etc.) für Chat- und Einbettungsmodelle
  • API-Schlüssel - Verwalten Sie die API-Authentifizierung und den Zugriff
  • Versionen - Erstellen und verwalten Sie verschiedene Bot-Versionen

Inhaltsverwaltung​

Verwalten Sie das Wissen und die konversationelle Logik Ihres Bots:

  • Agentenmodus - Der KI-gesteuerte Weg, einen Bot zu erstellen: Beschreiben Sie, was er tun soll, und ein Orchestrator verwaltet Gespräche mit einer Persona, einem Prompt und Tools (die Alternative zum manuellen Erstellen von Flows)
  • Flows - Entwerfen Sie konversationelle Flows mit verschiedenen Knoten für die Interaktionslogik
  • Wissen - Laden Sie Dokumente (PDF, TXT, DOCX, MD), Texte oder Website-Inhalte hoch, um die Wissensbasis Ihres Bots aufzubauen
  • Skripte - Fügen Sie benutzerdefinierte Code-Snippets für erweiterte Funktionalität hinzu
  • Medien - Verwalten Sie Medienressourcen wie Bilder, Dokumente, Audio- oder Videodateien
  • ConfigMap - Speichern Sie Konfigurationswerte, API-Schlüssel und umgebungsspezifische Einstellungen

Kanäle​

Stellen Sie Ihren Bot über verschiedene Kommunikationskanäle bereit:

  • Website - Betten Sie Ihren Bot auf Websites mit anpassbarem Design und Chat-Widgets ein
  • Telefon - Konfigurieren Sie sprachbasierte Interaktionen mit STT/TTS-Einstellungen
  • IMAP Mail - Verwalten Sie E-Mail-basierte Gespräche
  • Wissensmanager - Bearbeiten Sie den Wissenszugriff über Kanäle hinweg

Testen​

Stellen Sie sicher, dass Ihr Bot wie erwartet funktioniert, mit automatisierten Tests:

  • Erstellen Sie Testfälle aus echten Gesprächen
  • Definieren Sie Validierungsbedingungen für Bot-Antworten
  • Automatisieren Sie Regressionstests für Ihre Flows

Dashboard & Analytik​

Überwachen und analysieren Sie die Leistung Ihres Bots:

  • Analytik - Verfolgen Sie Gespräche, Benutzerengagement und Leistungsmetriken
  • Verlauf - Überprüfen Sie Gesprächsprotokolle und Benutzerinteraktionen

Livechat​

Ermöglichen Sie die Übergabe an menschliche Agenten und Live-Support:

  • Übersicht - Überwachen Sie die Agentenaktivität und die Gesprächsverteilung
  • Chats - Verwalten Sie Ihre aktiven Gespräche
  • Gruppen - Organisieren Sie Agenten in Teams
  • Einstellungen - Konfigurieren Sie Livechat-Parameter

Erstellen Sie Ihren ersten Bot: Schritt für Schritt​

Folgen Sie diesem Leitfaden, um Ihren ersten konversationellen Bot zu erstellen und bereitzustellen:

Schritt 1: Erstellen Sie Ihren Bot​

Erklärung: Das Folgende beschreibt die einzelnen Schritte zur Initialisierung eines Bots.

  1. Navigieren Sie zur Übersicht Seite
  2. Klicken Sie auf die Plus-Schaltfläche (+), um einen neuen Bot zu erstellen
  3. Wählen Sie den Modus des Bots - Agentenmodus (KI-gesteuert) oder Flow-basiert (manuelle Flows). Dies wird im Voraus entschieden, bevor Sie Inhalte konfigurieren, und kann später nicht geändert werden. Siehe Agentenmodus für den Unterschied.
  4. Konfigurieren Sie die Einstellungen Ihres Bots (Name, Beschreibung, visuelles Tag)
  5. Bewegen Sie die Maus an den linken Rand, um die Menüleiste zu erweitern. Dort finden Sie alle relevanten Unterpunkte zur Bot-Erstellung.
Modusauswahl erscheint möglicherweise nicht

Wenn Ihre Installation den Agentenmodus nicht aktiviert hat, wird Schritt 3 übersprungen und jeder neue Bot wird als Flow-basiert erstellt. Siehe Agentenmodus für Details.

Agentenmodus erhält einen Vorsprung

Wenn ein KI-Anbieter bereits konfiguriert ist, verwendet der Agentenmodus Ihre Bot-Beschreibung, um einen ersten Entwurf des Bots zu generieren - seine Persona, Orchestrator-Prompt und Tools - mit der integrierten KI-Unterstützung. Sie können es so verwenden, wie es ist, oder es von dort aus verfeinern.

Schritt 2: KI-Anbieter-Konfiguration​

Erklärung: Das System verwendet mehrere spezialisierte Anbieter für den Betrieb, einschließlich Chat-Generierung, Vektorisierung von Wissenstexten (Einbettungen) und Telefonie- und Sprachdienste.

  1. Gehen Sie zum Anbieter Abschnitt
  2. Fügen Sie Ihre KI-Anbieter-Anmeldeinformationen hinzu (OpenAI, Azure, etc.)
  3. Wählen Sie ein Chat-Modell zur Generierung von Antworten
  4. Wählen Sie ein Einbettungsmodell, wenn Sie wissensbasierte Funktionen verwenden möchten
  5. Aktivieren Sie den Anbieter und setzen Sie ihn als Standard

Schritt 3: Wissen hinzufügen (Optional)​

Erklärung: In diesem Schritt wird externes, domänenspezifisches Wissen in Form von Dokumenten, Texten oder URLs aufgenommen, vektorisiert (Einbettungen) und in einer Wissensbasis gespeichert, um kontextuell relevante und präzise Antworten durch Retrieval-Augmented Generation (RAG) zu ermöglichen.

  1. Navigieren Sie zu Wissen unter Inhalt
  2. Laden Sie relevante Dokumente hoch, fügen Sie Textinhalte hinzu oder geben Sie URLs an
  3. Verwenden Sie Tags, um spezifisches Wissen für bestimmte Themen zu priorisieren
  4. Ihr Bot wird dieses Wissen verwenden, um genaue, kontextbezogene Antworten zu geben

Schritt 4: Konversationelle Flows entwerfen​

Erklärung: In diesem Schritt entwerfen Sie die Interaktionslogik Ihres Bots, indem Sie Flows aus einzelnen Knoten erstellen. Ein Flow definiert, wie der Bot auf Benutzeranfragen reagiert, Informationen sammelt, Wissen abruft oder externe Aktionen ausführt. Es gibt eine Unterscheidung zwischen Hauptflows und Subflows. Hauptflows sind autonome konversationelle Pfade, die der Bot basierend auf der Benutzeranfrage auswählt. Hier kommt der Orchestrator ins Spiel: Er analysiert die Benutzereingabe, erkennt die Absicht und entscheidet, welchen Hauptflow er auslösen soll. Subflows sind wiederverwendbare Komponenten, die innerhalb von Hauptflows aufgerufen werden, zum Beispiel für Authentifizierung oder wiederkehrende Dialogmuster.

Ein typisches Beispiel ist ein Support-Flow für den Bestellstatus, bei dem nur registrierte Benutzer Zugriff auf Informationen haben. Der Orchestrator erkennt, dass die Benutzeranfrage Schlüsselwörter wie "Bestellung" oder "Versand" enthält und wählt automatisch den Hauptflow "Bestellstatus abrufen" aus.

Gleich zu Beginn ruft der Hauptflow einen "Authentifizierungs"-Subflow auf, der die Anmeldung des Benutzers überprüft.

In diesem Subflow wird der Benutzer zunächst nach E-Mail und Passwort gefragt (Formular-Knoten), und ein Aktionsknoten überprüft die Eingaben im Authentifizierungssystem.

Bei erfolgreicher Anmeldung kehrt der Flow zum Hauptflow zurück; bei fehlgeschlagener Anmeldung erhält der Benutzer eine entsprechende Fehlermeldung und kann es erneut versuchen.

Zurück im Hauptflow fordert der Bot zunächst die Bestellnummer an (entweder über einen Formular-Knoten oder einen Antwort-Knoten mit Frage → Benutzereingabe-Knoten → Formular-Knoten, siehe Screenshot). Im Formular-Knoten werden Anweisungen zur Extraktion in der Prozessbeschreibung hinzugefügt.

Nach erfolgreicher Extraktion wird das Validierungsskript aufgerufen und überprüft, ob die extrahierte Bestellnummer mit einem "b" beginnt. Dann führt der Bot einen API-Aufruf an das Bestellsystem durch, um die aktuellen Daten abzurufen.

Schließlich liefert ein Antwort-Knoten die Antwort an den Benutzer: zum Beispiel "Ihre Bestellung mit der Nummer X befindet sich derzeit im Versand."

Durch die Trennung von Hauptflows und Subflows und die Verwendung des Orchestrators bleibt die konversationelle Logik klar, wiederverwendbar und sicher. Wiederkehrende Komponenten wie Authentifizierung oder API-Aufrufe können in mehreren Flows verwendet werden, ohne die Logik zu duplizieren.

  1. Gehen Sie zu Flows unter Inhalt
  2. Klicken Sie auf Erstellen, um einen neuen Flow zu erstellen
  3. Definieren Sie den Zweck des Flows und die Auslösebedingungen
  4. Fügen Sie Knoten hinzu, um die konversationelle Logik zu entwerfen:
    • Formular-Knoten für Fragen und Extraktion von Benutzereingaben
    • Antwort-Knoten für Antworten oder Fragen
    • Benutzereingabe-Knoten, durch die Benutzer Informationen bereitstellen
    • Wissensknoten für Wissensabruf
    • Aktionsknoten für Logik- oder API-Anfragen
  5. Setzen Sie einen Flow als Ihren Standard-Flow, um allgemeine Anfragen zu bearbeiten

Schritt 5: Konfigurieren Sie Ihren Kanal​

Erklärung: In diesem Schritt richten Sie den Kanal ein, über den Benutzer mit Ihrem Bot interagieren. Dies kann Ihre Website, ein Messenger oder eine andere Plattform sein. Sie passen das Erscheinungsbild und die Grundeinstellungen an.

  1. Besuchen Sie den Website Abschnitt (oder Ihren bevorzugten Kanal)
  2. Passen Sie das Erscheinungsbild des Bots an (Avatar, Farben, Icon)
  3. Richten Sie eine Anfangsnachricht ein, um Benutzer zu begrüßen
  4. Konfigurieren Sie CORS-Einstellungen für Ihre Domain
  5. Kopieren Sie den Einbettungscode, um den Bot zu Ihrer Website hinzuzufügen

Schritt 6: Testen Sie Ihren Bot​

Erklärung: Bevor der Bot live geht, sollten alle Gespräche getestet werden. Dies stellt sicher, dass Absichten, Flows und Wissen korrekt funktionieren.

  1. Verwenden Sie den Entwicklungs-Chat, der auf jeder Seite verfügbar ist, um Gespräche zu testen
  2. Erstellen Sie automatisierte Testfälle aus Ihren Gesprächen
  3. Fügen Sie Bedingungen hinzu, um das Bot-Verhalten zu validieren
  4. Führen Sie Tests durch, bevor Sie Updates bereitstellen

Schritt 7: Überwachen & Optimieren​

Erklärung: Ein Bot ist nie "fertig". Überwachung und Optimierung stellen sicher, dass er im Laufe der Zeit genau, hilfreich und benutzerfreundlich bleibt.

  1. Überprüfen Sie das Analytik Dashboard für Einblicke
  2. Überprüfen Sie den Gesprächs**Verlauf**, um Probleme zu identifizieren
  3. Aktivieren Sie Livechat für menschlichen Agenten-Support, wenn nötig
  4. Verfeinern Sie kontinuierlich Ihre Flows und Wissensbasis basierend auf Benutzerinteraktionen

Schlüsselkonzepte​

Agentenmodus vs. Flow-basiert​

Jeder Bot ist einer von zwei Modi, die bei seiner Erstellung gewählt werden und für seine Lebensdauer festgelegt sind:

  • Agentenmodus - ein KI-Orchestrator entscheidet, was bei jedem Zug basierend auf einer Persona, einem Orchestrator-Prompt und einem Satz von Tools zu tun ist. Sie beschreiben den Bot und verfeinern ihn; Sie verdrahten nicht jeden Schritt. Empfohlen für die meisten neuen Bots.
  • Flow-basiert - Sie erstellen jeden Schritt selbst als Flows und Knoten. Am besten für starre, vollständig deterministische Prozesse.

Siehe Agentenmodus für den vollständigen Vergleich und die Konfigurationsdetails.

Flows vs. Subflows​

  • Flows sind autonome konversationelle Pfade, die der Orchestrator basierend auf der Benutzerabsicht auswählen kann
  • Subflows sind wiederverwendbare konversationelle Komponenten, die manuell ausgelöst werden müssen
  • Standard-Flow behandelt alle Anfragen, wenn kein spezifischer Flow übereinstimmt

Wissensmanagement​

  • Laden Sie verschiedene Dokumenttypen hoch, um eine Wissensbasis zu erstellen
  • Verwenden Sie Tags, um spezifisches Wissen für bestimmte Themen zu priorisieren
  • Das Einbettungsmodell konvertiert Dokumente in durchsuchbare Stücke
  • RAG (Retrieval-Augmented Generation) Knoten rufen relevantes Wissen während Gesprächen ab

Visuelle Tags​

Verwenden Sie visuelle Tags, um verschiedene Bot-Versionen zu verwalten:

  • DEV - Entwicklung und Testen
  • STAGING - Vorproduktionsvalidierung
  • PROD - Live-Produktionsumgebung

Anbieter-Konfiguration​

  • Chat-Modell - Generiert konversationelle Antworten
  • Einbettungsmodell - Ermöglicht Wissensabruf und Suche
  • Orchestrator - Bestimmt, welchen Flow basierend auf Benutzereingaben verwendet werden soll

Bot-Persona​

Definieren Sie die Persönlichkeit und den Kommunikationsstil Ihres Bots in den Einstellungen. Die Bot-Persona wird automatisch auf alle Agentenantworten angewendet, um einen konsistenten Ton und ein konsistentes Verhalten über Antwortknoten, Wissensknoten, Formularknoten und den Orchestrator hinweg sicherzustellen. Siehe die Einstellungen Seite für Details zur Konfiguration und Verwendung der Bot-Persona.

Nächste Schritte​

Jetzt, da Sie die Plattformstruktur verstehen, hier einige empfohlene Wege:

Für einen schnellen Start:

  1. Beginnen Sie mit einem Vorlagen-Bot aus der Übersicht
  2. Erkunden Sie den Entwicklungs-Chat, um Interaktionen zu testen
  3. Überprüfen Sie die vorkonfigurierten Flows und das Wissen

Für individuelle Entwicklung:

  1. Erfahren Sie mehr über Flow-Design und Knotentypen
  2. Verstehen Sie, wie man Wissensbasen aufbaut
  3. Erkunden Sie erweiterte Funktionen wie Skripte und ConfigMap

Für die Produktionsbereitstellung:

  1. Richten Sie ordnungsgemäße Anbieter-Konfigurationen ein
  2. Konfigurieren Sie API-Schlüssel für Sicherheit
  3. Erstellen Sie Versionskopien für sichere Bereitstellungen
  4. Aktivieren Sie Analytik und Livechat zur Überwachung

Brauchen Sie Hilfe?​

  • Verwenden Sie den Entwicklungs-Chat, um Ihren Bot in Echtzeit zu testen
  • Erstellen Sie Testfälle aus Gesprächen, um Probleme zu debuggen
  • Überprüfen Sie das Analytik Dashboard, um Problemfelder zu identifizieren
  • Überprüfen Sie Verlaufsprotokolle für detaillierte Gesprächsverläufe

Viel Erfolg beim Erstellen Ihres Bots!