rajudandigam/agent-inspect

何を解決するか

エージェントのコードは複雑であり、単一の関数呼び出しで失敗することは稀です。計画、ツールの使用、そしてリトライが含まれます。フラットなログでは、実行パスを可視化し、最初の原因となる失敗を特定することが困難です。AgentInspectは、エージェントの実行を読みやすい実行ツリーとしてキャプチャするローカルファーストのアプローチを提供し、開発者がデバッグ、CIでの軌跡の検証、そしてホストされたサービスを必要とせずに匿名化された証拠を共有することを可能にします。

仕組み

エージェントの実行をローカルのJSONLファイルとしてキャプチャします。これらのトレースを、ネストされたステップ、ツール呼び出し、およびLLMメタデータを含む実行ツリーとして表示するためのCLIを提供します。開発者が「トレース契約（trace contracts）」(決定論的なルール)を定義して、エージェントが正しい軌跡に従ったかどうか（例：特定のツールが呼び出されたことを確認する）をチェックすることを可能にします。これらのトレースは、匿名化（redacted）され、共有のためにポータブルでハッシュ検証可能な証拠アーティファクトにまとめられます。

対象者

LangChain、LangGraph、AI SDK、またはOpenAI Agents JSなどのフレームワークを使用してAIエージェントを構築しているTypeScript開発者、およびカスタムのエージェントワークフローを使用している開発者。

ハイライト

• Local-first: アカウント、コレクター、またはデフォルトのアップロードは不要です。トレースは開発者のマシンに留まります。
• Deterministic Trajectory Checks: 特定のツール呼び出しや完了ステータスに基づいてCIビルドを失敗させます。
• Evidence Bundling: PRやインシデントレポート用に、匿名化されたオフラインのアーティファクトを作成します。
• Broad Integration: 複数のTypeScript AIフレームワークと、OpenInference/OTLP JSONのような標準形式をサポートします。
• MCP Server: CursorのようなMCPクライアントにローカルの証拠を公開するためのオプションのサポートを提供します。