Agent-Probleme¶

Fehlerbehebung

Die meisten frühen Agentenprobleme entstehen durch unklare Prompts, fehlenden Gesprächsverlauf oder Tools, die zum falschen Zeitpunkt laufen. Grenzen Sie zuerst die Ursache ein.

Am Ende sollten Sie eine wahrscheinliche Ursache und eine konkrete Änderung zum Testen haben.

Die meisten Probleme beim ersten Start sind keine Infrastrukturfehler. Meist geht es um Prompt, Memory oder Tool-Timing. Starten Sie mit einem Testanruf, identifizieren Sie den genauen Fehler und ändern Sie eine Sache.

Der Agent erinnert sich nicht¶

Symptome:

der Agent fragt dieselbe Rückrufinformation zweimal,
das Gespräch wirkt wie getrennte Einzelschritte,
der Agent vergisst den bereits genannten Grund.

Sofort prüfen:

Conversation history limit ist in Technical gesetzt.
{conversation_history} steht im System-Prompt.

Wenn beides korrekt aussieht, prüfen Sie im Voice Debug Monitor, ob der Verlauf wirklich an das Modell gesendet wird.

Der Agent bestätigt die Rückrufnummer nicht¶

Meist ist der Prompt zu vage oder {caller_phone_number} wird nicht klar verwendet.

Prüfen Sie:

Prompt sagt ausdrücklich, dass der Agent fragen soll, ob {caller_phone_number} die beste Rückrufnummer ist.
{caller_phone_number} steht im Prompt.
Der Agent stellt nicht mehrere Fragen gleichzeitig.

Der Agent stellt zu viele Fragen auf einmal¶

Das ist ein Prompt-Disziplin-Problem. Ergänzen Sie klare Regeln:

eine Frage auf einmal,
nicht fortfahren, bis die aktuelle Information gesammelt oder geklärt ist.

Email Tool läuft zu früh¶

Symptome:

E-Mail wird gesendet, bevor die Rückrufnummer bestätigt wurde,
Handoff enthält keine Firma oder keinen Grund,
Agent beendet den Anruf zu früh.

Prüfen Sie:

Execution Description des Tools ist streng genug.
Prompt sagt klar, dass das Tool erst nach allen Callback-Fakten laufen darf.

Der Agent redet zu viel¶

Für Telefon-Callbacks sind lange Antworten meist schlechter.

Maßnahmen:

Max completion tokens auf 150 bis 250 setzen,
Temperature um 0.5,
Prompt-Regeln kürzen und Kürze ausdrücklich verlangen.

Der Agent wirkt zufällig¶

Wenn gleiche Prompts sehr unterschiedlich laufen:

Temperature auf 0.3 bis 0.5,
Prompt vereinfachen,
unnötige optionale Pfade entfernen.

Wissensdatenbank hilft nicht¶

Prüfen Sie:

richtige Wissensdatenbank verbunden,
{context} im Prompt,
Callback-Ablauf bleibt Hauptanweisung.

Eine Wissensdatenbank ersetzt keinen schwachen Callback-Prompt.

Praktische Reihenfolge¶

Wenn ein Testanruf fehlschlägt:

System-Prompt prüfen.
Conversation history limit prüfen.
Tool Execution Descriptions prüfen.
Voice Debug Monitor nutzen.
Ergebnis in Anrufhistorie prüfen.