Zum Inhalt

Voice Debug Monitor

Live-Debugging

Nutzen Sie den Voice Debug Monitor, wenn Sie Belege aus einem echten Anruf brauchen: was gesagt wurde, was erkannt wurde, welcher Kontext gesendet wurde und wann Tools liefen.

Debuggen Sie den Anrufpfad, bevor Sie Prompts neu schreiben oder mehrere Einstellungen ändern.

Nutzen Sie den Voice Debug Monitor, wenn Sie während eines Live- oder Testanrufs sehen müssen, was passiert. Das ist der schnellste Weg, um falsche Fragen, fehlende Details oder zu frühe Tool-Ausführung zu verstehen.

Wo finden?

Sie erreichen ihn typischerweise:

  • aus dem Agenten-Editor, wenn der Debug-Schritt verfügbar ist,
  • über das Aktionsmenü eines bestehenden Voice Agents.

Der Seitentitel im Produkt ist Voice Debug Monitor.

Wofür ist der Monitor gedacht?

Sie prüfen damit:

  • was Speech-to-Text tatsächlich verstanden hat,
  • was der Agent geantwortet hat,
  • ob der Backend-Debug-Stream aktiv ist,
  • wann Tools ausgeführt wurden,
  • ob Pre Processing Caller Lookup Kontext gespeichert hat,
  • ob Wissensdatenbank-Kontext, Gesprächsfakten oder Gesprächsverlauf injiziert wurden,
  • welche sprachbezogenen Prompt-Variablen und STT-Sprachkandidaten aktiv waren.

Für den Callback Assistant prüfen Sie hier, ob Name, Firma, Grund und Rückrufnummer in der richtigen Reihenfolge gesammelt werden.

Vor dem Start

Der Monitor ist am nützlichsten, wenn:

  • der Agent bereits einer Telefonnummer zugewiesen ist,
  • Sie einen echten oder kontrollierten Testanruf durchführen,
  • Debug enabled für den Voice Agent aktiv ist.

Wenn nichts erscheint, prüfen Sie Debug enabled und den Status Backend Debug On.

Was Sie sehen

Status-Badges

Oben sehen Sie Verbindung, Backend Debug On/Off, den Debug-Schalter und Clear timeline.

Call Setup

Der Bereich Call Setup zeigt, was beim Start des Anrufs passiert ist:

  • Begrüßungstext,
  • ob die Begrüßung nicht unterbrechbar war,
  • möglichen Greeting Timeout,
  • ausführenden Agenten,
  • Pre Processing Caller Lookup Status und gespeicherten Prompt-Kontext, wenn konfiguriert.

Nutzen Sie diesen Bereich, wenn Sie prüfen möchten, ob die Begrüßung korrekt lief oder ob {pre_call_context} vor der ersten Agentenantwort verfügbar war.

Pre-Processing-Ereignisse können Zustände wie Running, Saved, Failed oder Skipped zeigen. Anonyme Anrufernummern können übersprungen werden.

Caller Speech

Dieser Bereich zeigt:

  • aktuelle Teiltranskripte,
  • finalisierte Äußerungen,
  • Stillepausen.

Wenn Name, Firma oder Telefonnummer falsch erkannt werden, liegt die Ursache oft bei Erkennungssprache, Phrasenliste oder Timing, nicht beim Prompt.

Assistant Response

Dieser Bereich rekonstruiert die Antwort des Agenten.

Prüfen Sie:

  • ob der Agent beim Ablauf bleibt,
  • ob er nur eine Frage stellt,
  • ob er sich wiederholt,
  • ob er zu früh oder zu spät reagiert.

Ein gesunder Callback-Ablauf:

  1. Begrüßung
  2. Name
  3. Firma
  4. Grund des Anrufs
  5. Rückrufnummer bestätigen
  6. Tool-Ausführung
  7. kurzer Abschluss

Prompt-Kontext und Sprachvariablen

Der Monitor kann Prompt-Kontext anzeigen, zum Beispiel Persona, Standardsprache, erkannte gesprochene Sprache, aktive STT-Sprachen, erlaubte STT-Sprachen und Conversation Fact Summary.

Nutzen Sie das, wenn:

  • ein mehrsprachiger Agent in der falschen Sprache antwortet,
  • Spracherkennung mit den falschen Sprachkandidaten zu arbeiten scheint,
  • ein gespeicherter Fakt später nicht im Prompt zu erscheinen scheint,
  • Sie prüfen müssen, was der Agent zu einem bestimmten Zeitpunkt wusste.

Debug-Snapshots sind Momentaufnahmen. Wenn ein Fakt erst nach dem Aufbau eines Prompts gespeichert wird, erscheint er eventuell erst im nächsten Agenten-Turn.

Conversation Facts und History

Der Monitor kann Conversation Fact Summary Events und Conversation History Events anzeigen. Nutzen Sie diese, um zu prüfen, welchen Kontext der Agent zu einem bestimmten Zeitpunkt hatte.

Das hilft besonders, wenn:

  • der Agent bereits gespeicherte Details vergisst,
  • eine Post-Call-Zusammenfassung erwartete Fakten nicht enthält,
  • Sie testen, ob {conversation_history} und Fact Memory wirklich verfügbar sind.

Knowledge Base Query Details

Knowledge-Base-Ereignisse können Query-Transformationen, Confidence, Reasoning und Snippets zeigen. Nutzen Sie das, wenn der Agent aus Dokumenten antwortet, der abgerufene Kontext aber überraschend wirkt.

Wenn die transformierte Query falsch wirkt, korrigieren Sie Wissensdatenbank- oder Query-Transform-Anweisungen, bevor Sie unrelated Voice-Einstellungen ändern.

Typische Debug-Prüfungen

Agent überspringt eine Frage

Prüfen Sie System-Prompt, Tool-Ausführungsbeschreibung und Gesprächsverlauf.

Agent vergisst etwas

Prüfen Sie:

  • Conversation history limit in Technical,
  • {conversation_history} im Prompt.

Tool wird zu früh ausgelöst

Ein Tool sollte erst laufen, wenn alle Pflichtdetails gesammelt sind. Wenn es früher läuft, ist die Execution Description zu locker oder der Prompt nicht streng genug.

Namen werden falsch erkannt

Starten Sie bei Caller Speech und verbessern Sie Erkennungssprache, aktive/erlaubte STT-Sprachen oder Phrasenliste.

Caller Lookup liefert keinen Kontext

Prüfen Sie Call Setup und die Pre-Processing-Karte. Wenn die Abfrage fehlgeschlagen ist, übersprungen wurde oder einen unerwarteten Wert gespeichert hat, korrigieren Sie zuerst die Pre-Processing-Konfiguration.

Empfohlener Ablauf

  1. Testanruf durchführen.
  2. Caller Speech beobachten.
  3. Assistant Response prüfen.
  4. Tool-Zeitpunkt bestätigen.
  5. Eine Änderung vornehmen.
  6. Gleichen Testanruf wiederholen.

Ändern Sie nicht Speech, Prompt und Tool-Regeln gleichzeitig.

Häufige Callback-Checks

Name falsch erfasst

Starten Sie bei Caller Speech. Wenn die Transkription falsch ist, verbessern Sie Erkennungssprache, Phrasenliste oder Stille-Timing, bevor Sie den Prompt ändern.

Rückrufnummer nicht bestätigt

Prüfen Sie den Prompt-Ablauf. Der Agent sollte ausdrücklich fragen, ob {caller_phone_number} die richtige Rückrufnummer ist.

E-Mail wird nie gesendet

Prüfen Sie Execution Description und Debug-Timeline an der Stelle, an der das Tool hätte laufen sollen.

E-Mail enthält fehlende Felder

Das Tool lief wahrscheinlich zu früh. Verschärfen Sie die Triggerlogik, bevor Sie die E-Mail-Vorlage ändern.

Als Nächstes lesen