エージェントX線: トレースログからAIエージェントの障害をデバッグするためのオープンソースツール

Agent-Xrayは、AIエージェントのトレースログを分析してデバッグするためのオープンソースツールです。このツールは、明確なエラーがなくエージェントがタスクに失敗する問題を解決するために作成されました。例えば、コードは正常に実行されるものの、エージェントが誤った判断を下す状況、エラーメッセージが正しいツールを示唆しているにもかかわらず間違ったツールを繰り返し呼び出すような場合です。

主な機能

このツールはトレースログを読み取り、エージェントの失敗に対して構造的な評価と根本原因の分類を提供します。エージェントが各ステップで何を見ていたかを再構築し、なぜ誤った判断が下されたのかを理解するのに役立ちます。

失敗のカテゴリ

• spin
• tool_bug
• early_abort

強制実行モード

作成者によると、最も重要な機能は強制実行モードです。エージェントのバグを修正した後、このモードは敵対的チャレンジを実行して修正が正当であることを検証します。以下をチェックします：

• ハードコードされた戻り値
• 弱められたアサーション

これは、修正が特定のテストタスクでは機能するものの実際には脆弱である場合や、エージェントがテストを攻略することを学習する問題に対処します。

ワークフロー統合

このツールはMCPツールとして実行され、Claude Codeが直接使用できるようにします。ソースで説明されている典型的なワークフロー：

1. Claude Codeにエージェントトレースのトリアージを指示する
2. 最悪の失敗を見つける
3. エージェントが見ていたものを再生する
4. 修正を提案する
5. 強制実行モードで修正が正当であることを検証する

作成者はこれを「エージェントがエージェントをデバッグする」と表現しています。

技術的詳細

• インストール：pip install agent-xray
• クイックスタート：agent-xray quickstart（独自のデータなしでテストするためのサンプルトレースを含む）
• ライセンス：MIT
• 依存関係なし
• オフラインで実行可能
• OpenAI、Anthropic、LangChain、CrewAI、OpenTelemetryトレースと連携
• プロジェクトの経過日数：投稿時点で約9日

ユースケース

このツールは、従来のエラーやスタックトレースを生成しない失敗をデバッグする必要があるAIエージェントを扱う開発者向けです。エージェントが正しいツールと情報にアクセスできるにもかかわらず誤った判断を下す状況です。