アーカイブ / AI Agent / LLM
AIエージェントの長い実行記録から、失敗箇所と原因を報告するTraceSIR
TraceSIR
TraceSIRの原論文から掲載した図です。細部はクリックして拡大できます。
原論文の図の説明を読む
Figure 1: Comparison of existing methods and TraceSIR for agentic execution trace analysis and reporting.
概要
- TraceSIRは長い実行記録を判断・操作・結果の組に整理し、事例診断と横断報告に使う。
- 150件の失敗例を使った評価で、著者らはClaudeCodeより報告品質が平均9.7%高いと人間評価で報告した。
- 実務では原因の指摘が原記録に裏付けられるか、時間と出力のばらつきが許容できるかを測りたい。
補足:編集した模式図で仕組みを確認する
VISUAL EXPLAINER
図でつかむ、TraceSIRの仕組み
- 01操作と応答の記録
- 02判断・操作・結果に整理
- 03事例ごとに診断
- 04共通原因の報告
原論文の説明をもとにした模式図です。処理の細部は省略しています。
研究の背景
道具を使って調査や開発を進めるAIエージェントは、一つの依頼で多くの判断と操作を重ねる。失敗したとき、最終回答だけでは、どの操作で情報を取り違えたか分からない。実行記録全体を人が読み返す作業も、件数が増えると重い。
複数案件に共通する失敗を見つけるには、各案件の根拠を残しながら比較する必要がある。長い記録を診断に使える形へ縮め、改善担当者が読める報告にまとめることが課題だ。
手法
入力は一件の実行記録のJSON、または複数件をまとめたZIPで、各件には識別子とメッセージ列を含む。TraceFormatはメッセージを「判断・操作・結果」の組に並べ直し、StructureAgentが長すぎる部分を短くする。判断と道具の呼び出し、その返答の順番を保つことが、後の原因分析の手がかりになる。
InsightAgentは整えた記録から、課題の達成度、主な誤り、弱点、原因、改善案を案件ごとに出す。ReportAgentは案件が一定数ある場合、誤りの種類や得点の分布を集計し、参照した事例の記録を付けた報告書にする。例えばコード修正の失敗なら、誤った道具の結果を採用した時点を示し、同種の失敗が何件あるかをまとめる。
新規性
TraceSIRは、AIエージェントの実行記録を判断・操作・結果の対応を保った形式に変え、事例ごとの診断から複数事例の報告までつなぐ。TraceFormatという中間形式により、長い記録のどの操作が問題の根拠かを追いやすくする設計が中心だ。
研究は報告書そのものの品質を測るTraceBenchとReportEvalも提示した。完了率だけでは見えない失敗の位置、原因、改善提案を、記録に基づいて比較する評価枠組みを用意している。
従来手法との違い
手作業で記録を読む方法は、呼び出した道具や応答が増えるほど負担が大きい。生の記録をそのまま言語モデルに渡す方法は入力の長さが制約になり、最終結果だけを見る方法では失敗に至る操作をたどれない、と論文は説明する。
実験ではClaudeCodeを報告生成の比較対象とし、同じ三つの課題分野で品質を採点した。TraceSIRは記録を構造化して個別診断し、最後に複数事例を集計する。比較値は報告の品質についてのもので、エージェント本体の課題成功率が上がったことを示すものではない。
実験結果
著者らは調査のBrowseComp、道具の呼び出しを扱うTau2Bench、コード修正のSWE-benchから、GLM-4.6による失敗例を各50件、計150件集めてTraceBenchを作った。ReportEvalでは構成、誤りの分析、原因の分析、改善案、実務上の有用性を各10点で評価する。
報告書をClaudeCodeと比較した結果、著者らは人間の専門家6人による評価で平均9.7%、言語モデルを採点者にした評価で平均7.5%の相対改善を報告する。人間の評価者には手法名とモデル名を伏せた。数値は三分野の報告品質を示し、別の業務記録でも同じ差が出る保証ではない。
応用の可能性
編集上の応用案 · 論文が実証した用途とは区別しています。
編集上の応用案:社内の開発支援エージェントが修正に失敗した案件を集め、依頼内容、道具の呼び出し、返答を一件ずつ入力する。出力は、各案件で最初に判断を誤った箇所、その根拠となる記録、共通する失敗型をまとめた報告書とする。
担当者は報告書から元の操作履歴を開き、原因の説明が実際の記録と合うか確認する。そのうえで、例えばテスト結果の読み違いが多ければ、エージェントへの指示や確認手順を変更する候補として扱う。
応用先の候補からNauhに相談できます。
導入時の検証
導入時の検証案 · 対象データでの再評価が必要です。
導入時の検証案:既に担当者が原因を確認した失敗記録を少数選び、TraceSIR形式の診断と、現行の手作業による調査記録を並べる。各案件で、指摘された失敗箇所が原記録の操作・応答と一致するか、原因の説明に根拠があるかを数える。
複数案件の報告では、同じ失敗をまとめられた件数、見落とした共通原因、誤った改善提案を記録する。作成時間と入出力の量も測り、担当者が原記録を確認するまでを一つの作業として比較する。
限界と課題
著者らは、分析の質が内部の言語モデルの能力に左右されることを限界として挙げる。大量の事例を一度にまとめる際の報告の明瞭さ、応答時間とトークン消費、出力のばらつきも課題としている。実運用の記録には機密の指示文や道具の出力が含まれ得るとも述べる。
編集上の確認事項は、要約後も失敗原因を示す行が残るか、同じ記録から同程度の診断が再現されるかである。自動生成された原因説明を修正方針の唯一の根拠にせず、担当者が原記録と照合する運用が必要になる。
出典
元のタイトル・要旨を確認する(英語)
TraceSIR: A Multi-Agent Framework for Structured Analysis and Reporting of Agentic Execution Traces
Agentic systems augment large language models with external tools and iterative decision making, enabling complex tasks such as deep research, function calling, and coding. However, their long and intricate execution traces make failure diagnosis and root cause analysis extremely challenging. Manual inspection does not scale, while directly applying LLMs to raw traces is hindered by input length limits and unreliable reasoning. Focusing solely on final task outcomes further discards critical behavioral information required for accurate issue localization. To address these issues, we propose TraceSIR, a multi-agent framework for structured analysis and reporting of agentic execution traces. TraceSIR coordinates three specialized agents: (1) StructureAgent, which introduces a novel abstraction format, TraceFormat, to compress execution traces while preserving essential behavioral information; (2) InsightAgent, which performs fine-grained diagnosis including issue localization, root cause analysis, and optimization suggestions; (3) ReportAgent, which aggregates insights across task instances and generates comprehensive analysis reports. To evaluate TraceSIR, we construct TraceBench, covering three real-world agentic scenarios, and introduce ReportEval, an evaluation protocol for assessing the quality and usability of analysis reports aligned with industry needs. Experiments show that TraceSIR consistently produces coherent, informative, and actionable reports, significantly outperforming existing approaches across all evaluation dimensions. Our project and video are publicly available at https://github.com/SHU-XUN/TraceSIR.
論文本体の取得範囲に基づく解説。AIが作成した未校閲の記事です。性能の数値は著者の評価条件に依存します。応用例と検証計画は編集上の提案です。解説更新:2026-09-30




