Debugging
Das Debugging-Tool ist eine integrierte Testumgebung, mit der du Gespräche und einzelne Interaktionen deines AI Agents simulieren kannst – ohne dass echte Nutzer betroffen sind.
Wo finde ich das Debugging-Tool?
Das Tool lässt sich auf zwei Arten öffnen:
Global: Über den Button „Debugging öffnen" in der Navigationsleiste.
Flow Builder: Direkt aus einem Schritt heraus über das Käfer-Symbol oben rechts. In diesem Fall startet die Konversation exakt an dieser Stelle im Flow.
Beim Öffnen aus einem Schritt heraus musst du den vorherigen Flow-Verlauf nicht erneut durchlaufen. Die Simulation setzt direkt am gewählten Schritt an.
Erklärung – Was genau ist das Debugging-Tool?
Das Debugging-Tool ist eine isolierte Umgebung, in der du ganze Gespräche oder einzelne Interaktionen deines AI Agents simulieren kannst. Es dient dazu, Flows, Bedingungen und Variablen in Echtzeit zu testen, bevor sie produktiv eingesetzt werden.
Wichtige Eigenschaften
Sichtbarkeit: Das Tool öffnet sich als Overlay auf der rechten Seite des Bildschirms.
Umgebung: Die Konversation findet ausschließlich in der Entwicklungsumgebung statt. Sie wird nicht dauerhaft gespeichert und erscheint nicht in der Inbox.
Live-Testing: Änderungen an Flows sind sofort und ohne Versionierung testbar.
Änderungen an Intentionen oder Entitäten erfordern weiterhin die Erstellung eines neuen Modells bevor sie im Debugging-Tool wirksam werden.
Debug-Kanal
Bei der ersten Nutzung des Flow Builders wird automatisch ein interner Debug-Kanal im Hintergrund erstellt. Dieser Kanal ist in den Kanaleinstellungen sichtbar und dient ausschließlich der Kommunikation im Debugging-Tool.
Verwendung – Was kann man mit dem Debugging-Tool machen?
Debug-Chat nutzen
Der Debug-Chat simuliert einen Endnutzer-Kanal. Du kannst darin Nachrichten eingeben, als wärst du ein Nutzer deines AI Agents.
Die Konversation startet standardmäßig mit dem globalen Einstiegspunkt, sofern sie nicht aus einem spezifischen Schritt heraus gestartet wurde.
Die Unterhaltung bleibt erhalten, bis sie manuell zurückgesetzt wird. Du kannst das Overlay schließen und die Konversation später an derselben Stelle fortführen.
Um die Konversation zurückzusetzen, wähle das Uhrensymbol „Nachrichten zurücksetzen".
Nach dem Zurücksetzen kann die Konversation nicht wiederhergestellt werden.
Variablen-Monitor verwenden
Ein entscheidender Vorteil des Debug-Chats ist die Einsicht in das „Gedächtnis" deines AI Agents. Der Variablen-Monitor zeigt dir alle definierten Variablen und ihre aktuellen Echtzeit-Werte an.
Variablen-Monitor öffnen:
Öffne den Debug-Chat.
Klicke auf das Icon „Variablen" in der linken Seitenleiste des Chats.
Die Variablen-Übersicht der aktuellen Konversation wird angezeigt.
Variablen zurücksetzen:
Wähle das Uhrensymbol „Variablen zurücksetzen", um alle Variablen zu löschen bzw. auf ihre Standardwerte zurückzusetzen.
Werte manuell überschreiben:
Du kannst Variablenwerte direkt im Variablen-Monitor überschreiben, um verschiedene Szenarien zu testen. Das ist besonders nützlich, um Bedingungen mit unterschiedlichen Werten zu prüfen, ohne den gesamten Flow erneut durchlaufen zu müssen.
Beispiele
Flow-Logik mit manipulierten Variablen testen
Angenommen, dein Flow enthält eine Bedingung, die prüft, ob die Variable Anzahl Artikel (Benutzerdefiniert - Konversation) größer als 3 ist. Statt den gesamten Flow durchzuspielen, kannst du den Wert direkt im Variablen-Monitor ändern:
Öffne den Debug-Chat.
Öffne den Variablen-Monitor über das Icon „Variablen" in der linken Seitenleiste.
Suche die Variable
Anzahl Artikel (Benutzerdefiniert - Konversation).Überschreibe den Wert manuell – z. B. mit
5.Setze die Konversation fort und beobachte, ob die Bedingung korrekt den erwarteten Pfad wählt.
Wiederhole den Test mit einem anderen Wert – z. B.
2–, um auch den alternativen Pfad zu prüfen.
Entitäts-Erkennung überprüfen
Du möchtest testen, ob die Entität IBAN korrekt erkannt und in einer benutzerdefinierten Variable gespeichert wird:
Öffne den Debug-Chat über das Käfer-Symbol im entsprechenden Schritt, in dem die IBAN-Eingabe erwartet wird.
Gib eine Nachricht mit einer Test-IBAN ein, z. B.
DE89370400440532013000.Öffne den Variablen-Monitor und prüfe, ob die Entität
IBAN (Entität)den Wert korrekt enthält.Prüfe anschließend, ob der Wert wie erwartet in die benutzerdefinierte Variable
IBAN (Benutzerdefiniert - Kontakt)übernommen wurde (siehe Artikel „Variablen", Abschnitt „Werte von Entitäten in Variablen speichern").
Entitätswerte werden nach jeder neuen Benutzereingabe zurückgesetzt. Stelle sicher, dass der Wert rechtzeitig in einer benutzerdefinierten Variable gespeichert wird.
Best Practices
Gezielter Einstieg nutzen: Starte den Debug-Chat direkt aus einem Schritt heraus über das Käfer-Symbol. So kannst du komplexe Logiken am Ende eines langen Flows testen, ohne den gesamten Flow durchlaufen zu müssen.
Bedingungen systematisch testen: Nutze die Möglichkeit, Variablenwerte im Variablen-Monitor manuell zu ändern. Prüfe damit, ob Wenn-Dann-Bedingungen korrekt reagieren – z. B. wenn eine Variable leer ist, einen bestimmten Wert enthält oder einen Grenzwert über- bzw. unterschreitet.
Entitäten-Erkennung prüfen: Kontrolliere im Variablen-Monitor, ob Regex- oder Listen-Entitäten wie erwartet extrahiert werden. Beachte dabei, dass Entitätswerte sich nach jeder neuen Eingabe zurücksetzen, sofern sie nicht in benutzerdefinierten Variablen gespeichert werden (siehe Artikel „Variablen").
Debug-Chat und Web-Widget gezielt einsetzen: Verwende den Debug-Chat für schnelle Logik-Tests in der Entwicklungsumgebung. Nutze das Web-Widget für Tests, die in der Inbox erhalten bleiben sollen.
Last updated