rajudandigam/agent-inspect

它解决了什么问题

Agent 代码非常复杂，很少在单个函数调用中失败；它涉及规划、工具使用和重试。扁平化的日志使得可视化执行路径和识别第一个因果故障变得非常困难。AgentInspect 提供了一种“本地优先”的方法，将 Agent 运行过程捕获为可读的执行树，允许开发者进行调试、在 CI 中验证轨迹，并在无需托管服务的情况下分享脱敏后的证据。

工作原理

它将 Agent 运行过程捕获为本地 JSONL 文件。它提供了一个 CLI 来将这些追踪（traces）以执行树的形式查看，包括嵌套步骤、工具调用和 LLM 元数据。它允许开发者定义“追踪合约”（trace contracts，即确定性规则）来检查 Agent 是否遵循了正确的轨迹（例如，确保调用了特定的工具）。这些追踪可以进行脱敏处理，并打包成可移植、可哈希验证的证据制品（evidence artifacts）以便分享。

适用人群

使用 LangChain、LangGraph、AI SDK 或 OpenAI Agents JS 等框架构建 AI Agent 的 TypeScript 开发者，以及使用自定义 Agent 工作流的开发者。

亮点

• 本地优先： 无需账号、收集器或默认上传；追踪数据保留在开发者的机器上。
• 确定性轨迹检查： 根据特定的工具调用或完成状态使 CI 构建失败。
• 证据打包： 为 PR 或事故报告创建脱敏的、离线的制品。
• 广泛的集成： 支持多种 TypeScript AI 框架以及 OpenInference/OTLP JSON 等标准格式。
• MCP Server： 可选支持将本地证据暴露给 Cursor 等 MCP 客户端。