agent-devtools

La biblioteca Agent DevTools es un depurador causal local-first para agentes de IA. Su propósito principal es responder a la pregunta "¿por qué mi agente se comportó de esta manera?" proporcionando una visibilidad profunda de todo el rastro de ejecución. La herramienta captura la ruta causal completa: qué entradas de memoria influyeron en la respuesta final, qué candidatos de recuperación se seleccionaron y por qué, y qué contexto se inyectó en el prompt. Luego compara una ejecución buena con una mala para resaltar en lenguaje sencillo la causa probable, como un valor de memoria obsoleto o un candidato de recuperación seleccionado incorrectamente. Las características clave incluyen una pestaña Replay para revisar la ejecución paso a paso, una vista Graph que muestra el flujo desde la entrada pasando por recuperación, memoria, construcción del prompt, inferencia del LLM y llamadas a herramientas, y una pestaña Diff dedicada que expone las diferencias exactas entre ejecuciones. El almacén SQLite local garantiza que todos los datos permanezcan privados y persistentes entre sesiones. La integración con LangChain es perfecta: los desarrolladores pueden instrumentar el código de su agente con un esfuerzo mínimo usando el gestor de contexto trace.run(), lo que permite el registro automático de cada entrada, paso de recuperación, operación de memoria, ensamblaje de prompt e invocación de herramientas. El panel sirve como una interfaz de usuario integral donde los usuarios pueden profundizar en cualquier aspecto del rastro, desde mutaciones de memoria hasta resultados de llamadas a herramientas, lo que facilita diagnosticar problemas rápidamente sin analizar manualmente los registros.