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 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/rajudandigamagent-inspect.svg)](https://yunodb.com/tools/rajudandigamagent-inspect?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/rajudandigamagent-inspect?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/rajudandigamagent-inspect.svg" alt="Featured on YunoDB" height="20"></a>