FUNDAMENTOS · AGENT INFRASTRUCTURE · 04
Observabilidade
Ver o comportamento interno de sistemas agênticos para operar, investigar e melhorar com confiança.
8 min de leituraLogs tradicionais são necessários, mas não suficientes.
Uma execução agêntica pode envolver múltiplas chamadas de modelo, ferramentas, decisões, retries e agentes. Observabilidade precisa conectar esses eventos em uma visão rastreável.
O objetivo é responder perguntas como: qual objetivo foi recebido, quais tools foram usadas, quanto custou, onde houve latência e por que a execução terminou dessa forma.
TELEMETRIA
Trace, metrics e logs
A combinação dessas três perspectivas ajuda a reconstruir comportamento e medir saúde operacional.
Mostram a sequência e dependência entre etapas de uma execução.
Medem latência, erro, custo, volume e outros indicadores agregados.
Registram eventos e detalhes úteis para investigação.
Capturam chamadas, respostas, tool calls e decisões relevantes.
CUSTO
Tokens também são telemetria
Uso de modelos afeta custo e latência. Medir tokens, modelo utilizado e tempo por etapa ajuda a otimizar qualidade versus eficiência.
FinOps para IA depende de observabilidade desde o início.
PRIVACIDADE
Observar sem vazar dados
Prompts, respostas e tool outputs podem conter dados sensíveis. Telemetria precisa aplicar masking, retenção e controle de acesso.
Observabilidade não pode se tornar um novo canal de exposição.
NA PRÁTICA
Investigando uma execução
Plataformas e padrões de tracing ajudam a correlacionar passos, custo, tokens, erros e latência.
PRINCÍPIO
Se você não consegue reconstruir uma execução, você não consegue operar um sistema agêntico com confiança.