agent-devtools

A biblioteca Agent DevTools é um depurador causal local-first para agentes de IA. Seu propósito central é responder à pergunta por que meu agente se comportou dessa maneira, oferecendo visibilidade profunda de todo o rastro de execução. A ferramenta captura o caminho causal completo: quais entradas de memória influenciaram a resposta final, quais candidatos de recuperação foram selecionados e por quê, e qual contexto foi injetado no prompt. Em seguida, compara uma execução boa com uma execução ruim para destacar em linguagem simples a provável causa, como um valor de memória desatualizado ou um candidato de recuperação selecionado incorretamente. Os principais recursos incluem uma aba Replay para revisão passo a passo da execução, uma visualização em Grafo mostrando o fluxo da entrada até recuperação, memória, construção do prompt, inferência do LLM e chamadas de ferramentas, e uma aba Diff dedicada que expõe as diferenças exatas entre execuções. O armazenamento SQLite local garante que todos os dados permaneçam privados e persistentes entre sessões. A integração com LangChain é perfeita: desenvolvedores podem instrumentar o código do agente com esforço mínimo usando o gerenciador de contexto trace.run(), permitindo o registro automático de cada entrada, etapa de recuperação, operação de memória, montagem de prompt e invocação de ferramenta. O dashboard serve como uma interface abrangente na qual os usuários podem aprofundar qualquer aspecto do rastro, desde mutações de memória até resultados de chamadas de ferramentas, facilitando diagnosticar problemas rapidamente sem análise manual de logs.