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 Wissensdatenbank-Kontext oder Gesprächsverlauf injiziert wurde.
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.
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:
- Begrüßung
- Name
- Firma
- Grund des Anrufs
- Rückrufnummer bestätigen
- Tool-Ausführung
- kurzer Abschluss
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 oder Phrasenliste.
Empfohlener Ablauf¶
- Testanruf durchführen.
- Caller Speech beobachten.
- Assistant Response prüfen.
- Tool-Zeitpunkt bestätigen.
- Eine Änderung vornehmen.
- Gleichen Testanruf wiederholen.
Ändern Sie nicht Speech, Prompt und Tool-Regeln gleichzeitig.