> For the complete documentation index, see [llms.txt](https://docs.epic-ai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.epic-ai.com/epic-ai-platform/epic-ai-platform/ai-agent/debugging.md).

# 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:

1. **Global:** Über den Button „Debugging öffnen" in der Navigationsleiste.
2. <code class="expression">space.vars.TERM\_FLOW\_BUILDER</code>**:** Direkt aus einem Schritt heraus über das Käfer-Symbol oben rechts. In diesem Fall startet die Konversation exakt an dieser Stelle im Flow.

{% hint style="info" %}
Beim Öffnen aus einem Schritt heraus musst du den vorherigen Flow-Verlauf nicht erneut durchlaufen. Die Simulation setzt direkt am gewählten Schritt an.
{% endhint %}

***

### 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 <code class="expression">space.vars.TERM\_AI\_AGENT</code>s 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.

{% hint style="info" %}
Änderungen an Intentionen oder Entitäten erfordern weiterhin die Erstellung eines neuen [Modells](/epic-ai-platform/epic-ai-platform/ai-agent/daten/modelle.md) bevor sie im Debugging-Tool wirksam werden.
{% endhint %}

#### Debug-Kanal

Bei der ersten Nutzung des <code class="expression">space.vars.TERM\_FLOW\_BUILDER</code>s 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 <code class="expression">space.vars.TERM\_AI\_AGENT</code>s.

* 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".

{% hint style="warning" %}
Nach dem Zurücksetzen kann die Konversation nicht wiederhergestellt werden.
{% endhint %}

#### Variablen-Monitor verwenden

Ein entscheidender Vorteil des Debug-Chats ist die Einsicht in das „Gedächtnis" deines <code class="expression">space.vars.TERM\_AI\_AGENT</code>s. Der Variablen-Monitor zeigt dir alle definierten Variablen und ihre aktuellen Echtzeit-Werte an.

**Variablen-Monitor öffnen:**

1. Öffne den Debug-Chat.
2. Klicke auf das Icon „Variablen" in der linken Seitenleiste des Chats.
3. 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:

1. Öffne den Debug-Chat.
2. Öffne den Variablen-Monitor über das Icon „Variablen" in der linken Seitenleiste.
3. Suche die Variable `Anzahl Artikel (Benutzerdefiniert - Konversation)`.
4. Überschreibe den Wert manuell – z. B. mit `5`.
5. Setze die Konversation fort und beobachte, ob die Bedingung korrekt den erwarteten Pfad wählt.
6. 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:

1. Öffne den Debug-Chat über das Käfer-Symbol im entsprechenden Schritt, in dem die IBAN-Eingabe erwartet wird.
2. Gib eine Nachricht mit einer Test-IBAN ein, z. B. `DE89370400440532013000`.
3. Öffne den Variablen-Monitor und prüfe, ob die Entität `IBAN (Entität)` den Wert korrekt enthält.
4. 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").

{% hint style="info" %}
Entitätswerte werden nach jeder neuen Benutzereingabe zurückgesetzt. Stelle sicher, dass der Wert rechtzeitig in einer benutzerdefinierten Variable gespeichert wird.
{% endhint %}

***

### 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](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale/web-kanal.md) für Tests, die in der Inbox erhalten bleiben sollen.