Erste Schritte
Willkommen zur Dokumentation der Bot-Plattform! Dieser Leitfaden hilft Ihnen, intelligente, konversationelle Bots mit unserer Plattform zu erstellen, zu konfigurieren und bereitzustellen.
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:
- 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 Funktionen 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 Konversationen
- 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 Konversationen
- 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 Konversationen, Benutzerengagement und Leistungsmetriken
- Verlauf - Überprüfen Sie Konversationsprotokolle und Benutzerinteraktionen
Livechat
Ermöglichen Sie die Übergabe an menschliche Agenten und Live-Support:
- Übersicht - Überwachen Sie die Agentenaktivität und die Verteilung der Konversationen
- Chats - Verwalten Sie Ihre aktiven Konversationen
- 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.
- Navigieren Sie zur Übersicht-Seite
- Klicken Sie auf die Plus-Schaltfläche (+), um einen neuen Bot zu erstellen
- Konfigurieren Sie die Einstellungen Ihres Bots (Name, Beschreibung, visuelles Tag)
- Bewegen Sie die Maus an den linken Rand, um die Menüleiste zu erweitern. Dort finden Sie alle relevanten Unterpunkte zur Bot-Erstellung.
Schritt 2: KI-Anbieter-Konfiguration
Erklärung: Das System verwendet mehrere spezialisierte Anbieter für den Betrieb, einschließlich der Chat-Generierung, der Vektorisierung von Wissenstexten (Einbettungen) und der Telefonie- und Sprachdienste.
- Gehen Sie zum Abschnitt Anbieter
- Fügen Sie Ihre KI-Anbieter-Anmeldedaten hinzu (OpenAI, Azure, etc.)
- Wählen Sie ein Chat-Modell zur Generierung von Antworten
- Wählen Sie ein Einbettungsmodell, wenn Sie wissensbasierte Funktionen nutzen möchten
- 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.
- Navigieren Sie zu Wissen unter Inhalt
- Laden Sie relevante Dokumente hoch, fügen Sie Textinhalte hinzu oder geben Sie URLs an
- Verwenden Sie Tags, um spezifisches Wissen für bestimmte Themen zu priorisieren
- Ihr Bot wird dieses Wissen nutzen, 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 auf Informationen zugreifen dürfen. 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. Anschließend 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.
- Gehen Sie zu Flows unter Inhalt
- Klicken Sie auf Erstellen, um einen neuen Flow zu erstellen
- Definieren Sie den Zweck des Flows und die Auslösebedingungen
- 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 den Wissensabruf
- Aktionsknoten für Logik- oder API-Anfragen
- 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.
- Besuchen Sie den Abschnitt Website (oder Ihren bevorzugten Kanal)
- Passen Sie das Erscheinungsbild des Bots an (Avatar, Farben, Symbol)
- Richten Sie eine Anfangsnachricht ein, um Benutzer zu begrüßen
- Konfigurieren Sie CORS-Einstellungen für Ihre Domain
- 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 Konversationen getestet werden. Dies stellt sicher, dass Absichten, Flows und Wissen korrekt funktionieren.
- Verwenden Sie den Entwicklungs-Chat, der auf jeder Seite verfügbar ist, um Konversationen zu testen
- Erstellen Sie automatisierte Testfälle aus Ihren Konversationen
- Fügen Sie Bedingungen hinzu, um das Bot-Verhalten zu validieren
- 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.
- Überprüfen Sie das Analytik-Dashboard für Einblicke
- Überprüfen Sie den Konversations**Verlauf**, um Probleme zu identifizieren
- Aktivieren Sie Livechat für menschlichen Agenten-Support, wenn nötig
- Verfeinern Sie kontinuierlich Ihre Flows und Wissensbasis basierend auf Benutzerinteraktionen
Schlüsselkonzepte
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 der Konversationen 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, welcher 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:
- Beginnen Sie mit einem Vorlagen-Bot aus der Übersicht
- Erkunden Sie den Entwicklungs-Chat, um Interaktionen zu testen
- Überprüfen Sie die vorkonfigurierten Flows und das Wissen
Für die individuelle Entwicklung:
- Erfahren Sie mehr über Flow-Design und Knotentypen
- Verstehen Sie, wie man Wissensbasen aufbaut
- Erkunden Sie erweiterte Funktionen wie Skripte und ConfigMap
Für die Produktionsbereitstellung:
- Richten Sie ordnungsgemäße Anbieter-Konfigurationen ein
- Konfigurieren Sie API-Schlüssel für die Sicherheit
- Erstellen Sie Versionskopien für sichere Bereitstellungen
- 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 Konversationen, um Probleme zu debuggen
- Überprüfen Sie das Analytik-Dashboard, um Problemfelder zu identifizieren
- Überprüfen Sie Verlaufsprotokolle für detaillierte Konversationstraces
Viel Erfolg beim Erstellen Ihres Bots!