agentfdr

agentfdr

**タイトル:** agentfdr — AIエージェントのデバッグツール、動作ログを可視化 **説明:** agentfdrはkamihork製のデバッグツール。AIエージェントのターンごとの実行ログを事後確認でき、ループや目標の逸脱、トークン浪費を検出。ゼロインストールでローカル動作。

agentfdrとは?AIエージェントの動作を可視化するデバッグツール

agentfdrは、AIエージェントのターンごとの実行ログを事後的に確認できるデバッグツールです。ループ、目標逸脱、トークン浪費をゼロインストルメンテーションで検出し、ローカル環境で動作します。自律エージェントセッションのフライトレコーダーとして、すべてのツールコール、コンテキストウィンドウの構成、出力トークンを記録し、障害発生後に分析できます。「見えるループを設計する」という思想のもと、目に見えないエージェントの動作を検査可能なタイムラインに変換します。

適用シナリオ

  • 無限ループのデバッグ: 「編集→テスト失敗→同じ編集」のサイクルに40分間ハマるエージェントを捕捉
  • 目標逸脱の検出: バグ修正を依頼したのに、ルーターをリファクタリングしている場面を特定
  • トークン浪費の分析: 巨大なツール結果がコンテキストウィンドウを圧迫し、キャッシュミスと毎ターン20万トークンの再読み込みが発生するケースを特定
  • 不良終了の調査: テストが失敗しているのに「完了!」と報告する、あるいは永遠に停止しないエージェントの原因を解明
  • CIパイプライン監視: agentfdr assert で自律パイプラインにトリップワイヤーを設定し、ループや過剰なトークン使用をブロック
  • コスト追跡: プロジェクト横断でトランスクリプトを集約し、モデル別の使用量と推定コストをサブスクリプションプランと照合
  • 事後報告書の生成: マークダウン形式のオートプシーレポートを生成し、IssueトラッカーやSlackスレッドにそのまま貼り付け可能

Core Features

  • タイムラインビューア

    全セッションを1画面で表示。各ターンのツールコール、コンテキストウィンドウ構成、出力トークン、プロンプトとコンパクションマーカーを確認

  • 異常検出

    ツールループ、エラー連続、コンテキスト肥大化、トークンスパイク、キャッシュスラッシング、ファイル変更の乱発、拒否応答を自動フラグ。証拠からワンクリックで詳細表示

  • ターン分析

    リサイズ可能なサイドパネルで使用量の内訳、各ツールコールの所要時間、結果サイズ、スニペットを表示。←/→キーでターンをステップ実行

  • ライブウォッチモード

    `agentfdr watch` で実行中のセッションをリアルタイム追跡、コンテキストの増加をその場で確認

  • CIゲート

    `agentfdr assert --no-loops --max-tokens 2M` で違反時に終了コード1を返し、自律パイプラインのトリップワイヤーとして機能

  • マークダウンオートプシー

    `agentfdr blame` で分析結果をマークダウン形式で出力、IssueやSlackにそのまま貼り付け可能

  • 使用量追跡

    全プロジェクトのトランスクリプトをサブスクリプション課金と同一形式で集約。現在の5時間ウィンドウ、日次履歴、週間ロールアップ、モデル別内訳と推定コストを表示

  • 予算調整

    プラン階層を自動検出し、予算を設定。Claude Codeの/usage画面と一度キャリブレーションすれば、制限に達する前に警告バーを表示

対象ユーザー

自律エージェントシステムを構築・保守するソフトウェアエンジニアやAI開発者。具体的には、エージェントループのデバッグ、予測不能な動作の調査、本番パイプラインでのトークンコスト管理に取り組む方々。また、エージェントワークフローにCIゲートを設定するQAエンジニアや、エージェント障害の事後報告書を必要とするチームリーダーにも有用です。

agentfdrの使い方

agentfdrはコマンドラインツールです。主なコマンドは以下の通りです:

  • agentfdr – 最新セッションのタイムラインを開く
  • agentfdr list – 全プロジェクトの記録済みセッションを一覧表示
  • agentfdr watch – 実行中のセッションをライブ追跡
  • agentfdr blame 35cb18 – 特定のIssueに対するマークダウンオートプシーを生成
  • agentfdr usage – プラン消費状況を表示(5時間ウィンドウ、日次、週次)
  • agentfdr assert --no-loops --max-tokens 2M – CIゲート。違反時に終了コード1を返す

サインアップやWebインターフェースは不要で、ターミナルコマンドでローカル動作します。

効果レビュー

agentfdrは、自律エージェントの障害が「見えない」という現実的な課題に取り組んでいます。デバッグツールとしての機能セットは充実しており、タイムライン可視化、異常検出、ライブ監視、CI統合、コスト追跡をカバー。コマンドラインインターフェースは、すでにターミナル環境で作業する開発者向けの設計です。サイト上にユーザーフィードバックや品質指標は提供されていませんが、ゼロインストルメンテーションとローカル動作に重点を置いているため、本番デバッグにオーバーヘッドを追加せず実用的です。エージェントループの設計に苦労しているチームにとって、無駄のない焦点を絞ったソリューションと言えるでしょう。

Frequently Asked Questions

agentfdrとは?
agentfdrはAIエージェントのデバッグツールです。エージェントの実行後にターンごとのログを解析し、無限ループや目的の逸脱(ゴールドリフト)、トークンの無駄遣いを特定できます。計装(インストルメンテーション)は一切不要です。
agentfdrの仕組みは?
ローカル環境で動作し、エージェントの実行ログを事後的に解析します。各ステップを可視化することで、コードを変更せずにループやゴールドリフトが発生した箇所を確認できます。
agentfdrを使うためにエージェントに計装は必要?
いいえ、agentfdrはゼロインストルメンテーションで動作します。既存のログを活用し、実行後にデバッグ情報を提供します。
agentfdrで解決できる問題は?
無限ループ、ゴールドリフト(エージェントが本来の目的から逸脱すること)、トークンの無駄遣いを特定できます。これによりAIエージェントの効率性と信頼性を向上させます。
agentfdrは無料で使える?
はい、agentfdrはオープンソースツールで無料です。GitHubリポジトリ(kamihork)で公開されています。
agentfdrはどんなAIエージェントフレームワークでも使える?
はい、実行ログを事後的に解析するため、フレームワークに依存しません。ログ出力を生成する任意のAIエージェントで利用可能です。

agentfdr - AI Tool Detail

**タイトル:** agentfdr — AIエージェントのデバッグツール、動作ログを可視化 **説明:** agentfdrはkamihork製のデバッグツール。AIエージェントのターンごとの実行ログを事後確認でき、ループや目標の逸脱、トークン浪費を検出。ゼロインストールでローカル動作。

Category:エージェント

Visit Link:https://kamihork.github.io/agentfdr/

Tags:AIエージェントデバッグ、実行ログ分析、トークン浪費検出、ゴールドリフト解析、ローカルデバッグツール