Observability voor e-mailagenten
Je kunt een e-mailagent niet in realtime zien werken.
Maar met één API-aanroep kun je alles zien wat hij gisteren heeft gedaan.
Het bouwen van agenten op e-mail biedt ingebouwde observability. De meeste autonome systemen hebben extra tools nodig voor tracing en logs. Een e-mailagent krijgt deze gratis omdat de mailbox het logboek is.
Zo gebruik je e-mail om je agenten te monitoren:
Input Monitoring Elk inkomend bericht triggert een message.created event. Dit levert de thread-ID op die je nodig hebt om het gesprek te reconstrueren. Als een bericht te groot is, zoek dan naar de message.created.truncated trigger. Dit geeft aan dat je de volledige body via de ID moet ophalen.
Output Monitoring Het platform rapporteert over elke verzending. Houd deze drie triggers bij om de status van je levering te zien: • message.send_success: De server van de ontvanger heeft de e-mail geaccepteerd. • message.send_failed: Een regel of beleid heeft de uitgaande e-mail geblokkeerd. • message.bounce_detected: De externe server heeft de e-mail geweigerd.
Een stijging in het aantal send_failed meldingen is je eerste teken van een probleem. Dit betekent dat een regel of een quotum je agent beperkt (throttling).
State Monitoring Mailboxmappen fungeren als een state machine. • Junk-map: Laat zien wat je spamfilters onderscheppen. • Concepten-map (Drafts): Dient als een goedkeuringswachtrij voor human-in-the-loop ontwerpen. Als een concept daar te lang blijft staan, ligt je goedkeuringsproces stil. • Verzonden-map (Sent): Biedt een perfect auditlog. Het logboek kan niet afwijken van de werkelijkheid, omdat de e-mail de werkelijkheid is.
Governance Monitoring Als een agent een bericht mist, controleer dan de regelbeoordelingen. Je kunt opvragen waarom een regel een bericht heeft geweigerd op