rajudandigam/agent-inspect

解決的問題

代理程式碼複雜，且很少在單一函式呼叫中失敗；它涉及規劃、工具使用和重試。平坦的日誌難以視覺化執行路徑並識別第一個因果失敗。AgentInspect 提供一種以本地為首的方法，將代理執行記錄為可讀的執行樹，讓開發者能夠除錯、在 CI 中驗證軌跡，並在不需要主機服務的情況下分享已遮蔽的證據。

如何運作

它將代理執行記錄為本地的 JSONL 檔案。它提供 CLI 以執行樹的形式檢視這些追蹤，包含巢狀步驟、工具呼叫和 LLM 元資料。它允許開發者定義「追蹤合約」（確定性規則），以檢查代理是否遵循正確的軌跡（例如，確保特定工具被呼叫）。這些追蹤可被遮蔽並打包成可攜帶、可雜湊驗證的證據資產以供分享。

適用對象

使用 LangChain、LangGraph、AI SDK 或 OpenAI Agents JS 等框架建構 AI 代理的 TypeScript 開發者，以及使用自訂代理工作流程的人。

特色

• 以本地為首： 無需帳戶、收集器或預設上傳；追蹤資料留在開發者的機器上。
• 確定性軌跡檢查： 根據特定工具呼叫或完成狀態來失敗 CI 建構。
• 證據打包： 建立遮蔽後、離線的資產，供 PR 或事件報告使用。
• 廣泛整合： 支援多個 TypeScript AI 框架和 OpenInference/OTLP JSON 等標準格式。
• MCP 伺服器： 可選支援，可將本地證據暴露給 Cursor 等 MCP 客戶端。