Observabilidade para Agentes de E-mail
Você não pode observar um agente de e-mail trabalhando em tempo real.
Mas você pode ver tudo o que ele fez ontem com apenas uma chamada de API.
Construir agentes baseados em e-mail oferece observabilidade nativa. A maioria dos sistemas autônomos requer ferramentas extras para rastreamento (tracing) e logs. Um agente de e-mail recebe isso gratuitamente porque a caixa de entrada é o registro.
Veja como usar o e-mail para monitorar seus agentes:
Monitoramento de Entrada Cada mensagem recebida aciona um evento
message.created. Isso fornece o ID da thread necessário para reconstruir a conversa. Se uma mensagem for muito grande, procure pelo gatilhomessage.created.truncated. Isso indica que você deve buscar o corpo completo via ID.Monitoramento de Saída A plataforma reporta cada envio. Acompanhe estes três gatilhos para verificar a saúde da sua entrega: • message.send_success: O servidor do destinatário aceitou o e-mail. • message.send_failed: Uma regra ou política bloqueou o e-mail de saída. • message.bounce_detected: O servidor remoto rejeitou o e-mail.
Um aumento nas contagens de send_failed é o seu primeiro sinal de problema. Isso significa que uma regra ou uma cota está limitando seu agente.
Monitoramento de Estado As pastas da caixa de entrada funcionam como uma máquina de estados. • Pasta de Spam (Junk): Mostra o que seus filtros de spam estão capturando. • Pasta de Rascunhos (Drafts): Serve como uma fila de aprovação para designs com "human-in-the-loop". Se um rascunho ficar lá por muito tempo, seu processo de aprovação está travado. • Pasta de Enviados (Sent): Fornece um log de auditoria perfeito. O log não pode divergir da realidade, pois o e-mail é a própria realidade.
Monitoramento de Governança Se um agente perder uma mensagem, verifique as avaliações de regras. Você pode consultar por que uma regra rejeitou uma mensagem na camada SMTP. Isso substitui o "achismo" por dados.
Um limite a ser lembrado: você pode rastrear a entrega, mas não pode rastrear se um humano abriu ou clicou em um link através desta API. Você também precisa registrar seu próprio raciocínio. A caixa de entrada mostra o que o agente fez, mas você deve registrar por que o agente decidiu fazê-lo.
Comece rastreando estes três:
- message.send_success
- message.send_failed
- message.bounce_detected
Falhas de entrada são barulhentas e óbvias. Falhas de saída são silenciosas. Rastrear esses sinais ajuda você a encontrar erros em minutos, em vez de semanas.
Fonte: https://dev.to/qasim157/observability-for-email-agents-4egn
Comunidade de aprendizado opcional: https://t.me/GyaanSetuAi