Observabilidad para agentes de correo electrónico
No puedes observar a un agente de correo electrónico trabajando en tiempo real.
Pero puedes ver todo lo que hizo ayer con una sola llamada a la API.
Construir agentes sobre el correo electrónico te brinda observabilidad integrada. La mayoría de los sistemas autónomos requieren herramientas adicionales para el rastreo (tracing) y los registros (logs). Un agente de correo electrónico obtiene esto de forma gratuita porque el buzón de correo es el registro.
Así es como puedes usar el correo electrónico para monitorear tus agentes:
Monitoreo de entrada (Input Monitoring) Cada mensaje entrante activa un evento message.created. Esto proporciona el ID del hilo que necesitas para reconstruir la conversación. Si un mensaje es demasiado grande, busca el disparador message.created.truncated. Esto te indica que debes obtener el cuerpo completo a través del ID.
Monitoreo de salida (Output Monitoring) La plataforma informa sobre cada envío. Rastrea estos tres disparadores para ver la salud de tus entregas: • message.send_success: El servidor del destinatario aceptó el correo. • message.send_failed: Una regla o política bloqueó el correo saliente. • message.bounce_detected: El servidor remoto rechazó el correo.
Un aumento en los conteos de send_failed es tu primera señal de un problema. Significa que una regla o una cuota está limitando a tu agente.
- Monitoreo de estado (State Monitoring) Las carpetas del buzón actúan como una máquina de estados. • Carpeta de correo no deseado (Junk): Te muestra lo que tus filtros de spam están capturando. • Carpeta de borradores (Drafts): Sirve como una cola de aprobación para diseños con intervención humana (human-in-the-loop). Si un borrador permanece allí demasiado tiempo, tu proceso de aprobación está estancado. • Carpeta de enviados (Sent): Proporciona un registro de auditoría perfecto. El