agent-devtools

Agent DevTools 库是一款本地优先的 AI 智能体因果调试器。其核心目标是通过提供对整个执行轨迹的深度可见性，回答“我的智能体为什么会有这样的表现？”这一问题。 该工具捕获完整的因果路径：哪些记忆条目影响了最终答案，哪些检索候选项被选中及其原因，以及注入了哪些上下文到提示词中。随后，它将一次“良好”的运行与一次“糟糕”的运行进行差异对比，用通俗的语言突出显示可能的原因，例如过时的记忆值或错误选择的检索候选项。 主要功能包括用于逐步执行审查的 Replay 选项卡、展示从输入经过检索、记忆、提示词构建、LLM 推理到工具调用整个流程的 Graph 视图，以及专门用于揭示运行间确切差异的 Diff 选项卡。本地 SQLite 存储确保所有数据保持私密，并能在不同会话间持久保存。 与 LangChain 的集成无缝衔接——开发人员可以使用 trace.run() 上下文管理器以极小的工作量对智能体代码进行插桩，从而自动记录每个输入、检索步骤、记忆操作、提示词组装和工具调用。仪表盘作为一个全面的用户界面，允许用户深入探究轨迹的任何方面，从记忆变更到工具调用结果，从而无需手动解析日志即可更轻松地快速诊断问题。