Sprachagenten debuggen
Nutze diese Seite, wenn etwas eindeutig kaputt ist und Anrufende es bemerken würden. Starte damit, das Problem in Agent testen zu reproduzieren, und verwende dann Gespräche, um genau zu sehen, was passiert ist und an welcher Stelle der Ablauf abweicht. Nutze Chat oder Webanruf im Agent testen-Popover für schnelle Reproduktionen und bestätige das Verhalten vor dem Launch noch einmal im Telefonanruf-Modus.Wo du zuerst schauen solltest
Gesprächshistorie
Greife auf die vollständige Gesprächshistorie inklusive Transkripten, Aktionen und Metadaten zu
Live-Transkript
Überwache die Live-Transkription und Agentenantworten während Testanrufen
Tool-Aktivität
Prüfe Details zu Weiterleitungen, Buchungen, benutzerdefinierten Aktionen und anderen verbundenen Schritten
Fehlerdetails
Sieh dir Meldungen an, die erklären, warum ein Schritt fehlgeschlagen oder nicht abgeschlossen wurde
Systematischer Debugging-Ansatz
Wenn etwas schiefgeht, gehe systematisch vor:Problem reproduzieren
Teste erneut, um zu bestätigen, dass das Problem reproduzierbar istNotiere die genauen Bedingungen, unter denen es auftritt
Komponente identifizieren
Bestimme, welcher Teil falsch wirkt:
- Spracherkennung
- Antwortqualität
- Sprachausgabe
- Tool- oder Integrationsausführung
- Wissensabruf
Logs prüfen
Öffne Gespräche und finde den problematischen AnrufPrüfe Transkript, Tool-Aktivität und sichtbare Fehlermeldungen
Komponenten einzeln testen
Isoliere die fehlerhafte Komponente:
- Anderen Transkribierer testen
- Einen einfacheren Prompt oder einfachere Fragen testen
- Eine andere Stimme testen
- Nur ein Tool zur Zeit auslösen
- Falls nötig, die verantwortliche Person des verbundenen Systems bitten, die Verfügbarkeit zu bestätigen
Debugging auf Komponentenebene
Nutze das Gesprächsprotokoll, um die fehlerhafte Komponente zu identifizieren, und wechsle dann zu der Spezialseite, die die Behebung abdeckt.| Wenn das Protokoll auf … hindeutet | Im Log prüfen | Spezialseite |
|---|---|---|
| Transkription ist falsch | Transkriptionstext vs. das Gesagte, fehlende Wörter, Sprachmismatch | Transkribierer und Anrufqualität & Latenz |
| KI-Antwort ist falsch | Vollständiger Gesprächskontext, abgerufenes Wissen, Prompt-Verhalten | Prompt-Leitfaden und Wissensprobleme |
| Sprachausgabe klingt falsch | Aufzeichnung, gesprochener Text, Aussprache, Stimmeinstellungen | Spracheinstellungen und Anrufqualität & Latenz |
| Tool-Ausführung fehlgeschlagen | Tool-Call-Ereignis, Request-Zusammenfassung, Response-Zusammenfassung, Fehlermeldung, Dauer | Tools & Integrationen und Benutzerdefinierte Aktionen |
| Wissensabruf fehlgeschlagen | Abgerufene Chunks, zugewiesene Wissensdatenbank, Elementstatus | Wissensprobleme |
| Gesprächstiming wirkt falsch | Gesprächswechsel, Unterbrechungen, Stille, Antwortlatenz | Anrufqualität & Latenz |
Gesprächslogs zum Debuggen nutzen
Jeder Testanruf erzeugt ein detailliertes Log, das in Gespräche abrufbar ist.Was in den Logs steht:
Basisinformationen:- Datum, Uhrzeit und Dauer des Anrufs
- Verwendeter Agent
- Telefonnummer (bei Telefontests)
- Anrufstatus (abgeschlossen, fehlgeschlagen usw.)
- Vollständiges Transkript (Nutzer + Agent)
- Zeitstempel für jede Nachricht
- Audioaufzeichnung, falls verfügbar
- Ausgelöste Tools mit Details
- Erfasste Tasteneingaben
- Ergebnisse der Ziel-Analyse
- Antworten von Insights sammeln
- Zusätzliche Metadaten
- Fehlermeldungen
- Filtere nach Agentenname, um Testanrufe zu finden
- Öffne einen bestimmten Anruf, um alle Details zu sehen
- Lies das Transkript, um die Problemstelle zu finden
- Prüfe Tool-Details, wenn Tools fehlgeschlagen sind
- Höre dir das Audio an, wenn das Transkript korrekt wirkt, das Audio aber nicht
- Prüfe Zeitstempel, um Antwortzeit-Probleme zu erkennen
Hilfe erhalten
Wenn du zusätzliche Unterstützung brauchst:Dokumentation prüfen
Prüfe die spezifischen Feature-Dokus für Konfigurationsdetails
Provider-Status prüfen
Prüfe den Service-Status aller Provider, von denen dein Agent abhängt
Support kontaktieren
Schreibe an support@itellico.ai mit Anruf-Logs und Fehlerdetails
- Agenten-ID oder -Name
- Gesprächs-ID aus den Logs
- Konkrete Fehlermeldungen
- Schritte zur Reproduktion
- Screenshots, falls sinnvoll
Nächste Schritte
Launch-Checkliste
Prüfe die Launch-Checkliste, um deinen Agenten für die Produktion vorzubereiten