Häufige Fallstricke beim Bau von E-Mail-Agenten
Ihr E-Mail-Agent funktioniert im Testbetrieb. Dann bringen Sie ihn auf den Markt. Über Nacht antwortet der Agent auf seine eigenen Nachrichten. Kunden erhalten dreimal dieselbe Antwort. Konversationsverläufe zerfallen in Einzelteile.
Diese Fehler treten auf der Infrastrukturebene auf, nicht aufgrund Ihres LLM-Prompts.
Überprüfen Sie diese neun Punkte, bevor Sie live gehen:
Die Endlosschleife Der Webhook wird ausgelöst, wenn Ihr Agent eine Antwort sendet. Dies löst einen weiteren Webhook aus. Sie erzeugen eine Schleife. Lösung: Filtern Sie die E-Mail-Adresse des Agenten ganz oben in Ihrem Code. Brechen Sie den Prozess ab, wenn der Absender der Agent ist.
Doppelte Nachrichten Das Netzwerk gerät ins Stocken. Ihr Endpunkt antwortet nicht schnell genug. Das System sendet dieselbe Benachrichtigung erneut. Lösung: Verwenden Sie eine atomare Prüfung der Nachrichten-ID. Nutzen Sie Redis oder Postgres, um sicherzustellen, dass jede ID nur einmal verarbeitet wird.
Race Conditions Zwei Worker verarbeiten dasselbe Ereignis im selben Millisekundenbereich. Eine reine Deduplizierung reicht hier nicht aus. Lösung: Verwenden Sie einen threadspezifischen Lock mit einem 30-Sekunden-Limit. Prüfen Sie innerhalb dieses Locks, ob der Agent bereits geantwortet hat.
Abgeschnittene Daten Webhooks enthalten oft nur Zusammenfassungen, nicht den vollständigen Inhalt. Große E-Mails könnten als gekürzte Ereignisse ankommen. Lösung: Rufen Sie die vollständige Nachricht immer über die ID von der API ab. Verlassen Sie sich für den Inhalt nicht auf das Webhook-Payload.
Unterbrochene Threads Das Senden einer Antwort als neue Nachricht zerstört die Gruppierung von Konversationen in Gmail oder Outlook. Lösung: Übergeben Sie bei jeder Antwort die
reply_to_message_id. Verknüpfen Sie Antworten über diethread_id, niemals über die Betreffzeile.Die menschliche Korrektur Ein Mensch sendet Sekunden nach seiner ersten E-Mail eine korrigierende Ergänzung. Ihr Agent antwortet auf beide. Lösung: Nutzen Sie eine Abkühlphase (Cooldown) von 30 bis 60 Sekunden. Fassen Sie aufeinanderfolgende Nachrichten in einer einzigen Antwort zusammen.
Der Antwortsturm Ein Logikfehler führt dazu, dass der Agent augenblicklich hunderte E-Mails versendet. Lösung: Legen Sie ein Sende-Budget pro Thread fest. Wenn der Agent 3 Nachrichten innerhalb von 5 Minuten sendet, stoppen Sie und benachrichtigen Sie einen Menschen.
Müll-Input Spam und Abwesenheitsnotizen lösen Ihren LLM aus. Sie bezahlen für nutzlose Inferenz. Lösung: Nutzen Sie Posteingangsregeln, um unerwünschte Absender zu blockieren oder automatisierte E-Mails in einen anderen Ordner zu verschieben.
Die 403-Fehlerfalle Ausgehende Regeln können den Versand blockieren. Dies führt zu einem 403-Fehler. Standardmäßige Retry-Logik wird diesen Fehler endlos wiederholen. Lösung: Behandeln Sie den 403-Fehler als terminalen Fehler. Versuchen Sie es nicht erneut. Wenn Sie einen 503 erhalten, können Sie einen Retry durchführen.
Langweilige Lösungen wie Filter, Locks und Limits sind das, was einen Agenten sicher macht.
Quelle: https://dev.to/qasim157/common-pitfalls-building-email-agents-and-fixes-29kg
Optionale Lern-Community: https://t.me/GyaanSetuAi