Texto da publicação no LinkedIn
Como saber o que um agente de IA realmente fez?
Concluiu a tarefa? Errou ou se desviou? Quanto tempo e quanto custou? A resposta está no rastreamento: cada passo do agente vira um span dentro de um trace.
Comparei 13 plataformas (Anthropic, OpenAI, Google, Microsoft, AWS e 7 independentes). As versões foram lidas no PyPI e no npm em 10/10/2026 e os recursos na documentação oficial. O que encontrei:
🟦 Span, trace e sessão: span é uma etapa rastreada (chamada ao modelo, uso de ferramenta, handoff); trace é a jornada completa; sessão agrupa vários traces da mesma conversa.
🟩 Trace não prova acerto: execução sem erro só mostra que o agente não quebrou. Falhas de conteúdo muitas vezes não disparam nenhum status de erro, então é preciso avaliação separada.
🟧 OpenTelemetry é o caminho da portabilidade, mas as convenções GenAI ainda estão em status Development: nomes podem mudar.
🟪 Privacidade muda por plataforma: o Claude Agent SDK não registra conteúdo por padrão; o OpenAI Agents SDK registra entradas e saídas, a menos que você desative.
🟥 Falha silenciosa: em pelo menos uma plataforma, erro de exportação da telemetria não aparece. Trace ausente pode ser falha de exportação.
🟨 Maturidade: traces do Claude Agent SDK e Managed Agents em beta; tracing de workflows do Foundry em preview; SDKs centrais ainda em 0.x.
📌 Conclusão: estamos no meio do amadurecimento. As soluções são, em boa parte, versões preliminares, e várias estão em beta ou preview. Nomes de spans, atributos e comportamentos podem mudar: adote prevendo o custo de migração.
✅ Boas práticas: instrumente por OTel, defina por escrito o que será capturado, monitore a própria exportação e separe "terminou sem erro" de "resultado correto".
O estudo completo traz glossário, 47 referências com validação e matriz comparativa por plataforma.
Qual ferramenta de rastreamento você usa nos seus agentes?