agent-devtools

La bibliothèque Agent DevTools est un débogueur causal local-first pour agents IA. Son objectif principal est de répondre à la question « pourquoi mon agent s'est-il comporté de cette façon ? » en offrant une visibilité approfondie sur l'ensemble de la trace d'exécution. L'outil capture le chemin causal complet : quelles entrées de mémoire ont influencé la réponse finale, quels candidats de récupération ont été sélectionnés et pourquoi, et quel contexte a été injecté dans le prompt. Il compare ensuite une exécution réussie à une exécution échouée pour mettre en évidence la cause probable en langage clair, comme une valeur de mémoire obsolète ou un candidat de récupération sélectionné incorrectement. Ses fonctionnalités clés incluent un onglet Relecture pour la révision pas à pas de l'exécution, une vue Graphique montrant le flux depuis l'entrée jusqu'à la récupération, la mémoire, la construction du prompt, l'inférence LLM et les appels d'outils, ainsi qu'un onglet Diff dédié qui fait ressortir les différences exactes entre les exécutions. Le stockage SQLite local garantit que toutes les données restent privées et persistantes entre les sessions. L'intégration avec LangChain est transparente : les développeurs peuvent instrumenter leur code d'agent avec un minimum d'effort en utilisant le gestionnaire de contexte trace.run(), permettant la journalisation automatique de chaque entrée, étape de récupération, opération de mémoire, assemblage de prompt et invocation d'outil. Le tableau de bord constitue une interface utilisateur complète où les utilisateurs peuvent explorer en détail tous les aspects de la trace, des mutations de mémoire aux résultats des appels d'outils, ce qui facilite le diagnostic rapide des problèmes sans analyse manuelle de journaux.