agent-inspect
TypeScript AI 代理的本地證據除錯器與軌跡測試工具組:檢查因果執行、在 CI 中捕捉錯誤工具路徑,並分享安全的離線證據
agent-inspect 是什麼?
TypeScript AI 代理的本地證據除錯器與軌跡測試工具組:檢查因果執行、在 CI 中捕捉錯誤工具路徑,並分享安全的離線證據。
agent-inspect 概覽
這是什麼
agent-inspect 是一個專為 TypeScript AI 代理設計的本地優先證據除錯與軌跡測試工具組。它將代理執行過程擷取為本機 JSONL 追蹤檔案,並提供工具來檢視執行路徑、在 CI 中執行確定性軌跡檢查,以及建立經過編輯且可驗證雜湊的離線證據工件。此工具組不需要帳戶、收集器或預設上傳,預設僅擷取中繼資料。
主要功能
- 將代理執行過程擷取為
.agent-inspect/或AGENT_INSPECT_TRACE_DIR目錄下的本機 JSONL 追蹤檔案。 - 提供 CLI 指令來檢視、報告和解釋執行樹,包含巢狀步驟、工具呼叫、LLM 呼叫、持續時間、錯誤和因果失敗。
- 支援使用預設規則和自訂規則(例如必要工具、完成預期)進行確定性軌跡檢查,通過時退出碼為
0,失敗時為1。 - 可透過
bundle和verify-safe指令建立經過編輯且可驗證雜湊的離線證據套件。 - 透過
agent-inspect/readers和agent-inspect/checks提供程式化 API 進行追蹤讀取和合約評估。 - 透過選用套件整合 LangChain、AI SDK、OpenAI Agents JS 等框架,以及 Vitest/Jest 測試工具。
- 包含選用的 MCP 伺服器以提供唯讀證據存取,以及安全分析表面。
使用情境
- 除錯單一本機 TypeScript 代理執行,了解其執行路徑和因果失敗。
- 在 CI 管線中強制執行確定性的工具呼叫順序、必要工具和完成預期。
- 將經過編輯且可驗證雜湊的離線工件附加到 PR、事件報告或支援交接中。
- 補充代管式可觀測性、生產追蹤保留和評估平台,用於本機和 CI 證據循環。
快速開始
bashnpm install agent-inspectnpx agent-inspect init --yesnode examples/agent-inspect-demo.mjsnpx agent-inspect list --dir .agent-inspect
授權與價格
採用 MIT 授權。開放原始碼。
內容整理自該專案公開的 README 與儲存庫資訊。