ApidogのAIエージェントデバッガーは、無料プランを含むすべてのプランで、最新のApidogクライアントで利用できます。このデバッガーを使用すると、OpenAIおよびAnthropicモデルに対してAIエージェントを実行したり、MCPサーバーを接続したり、トレースパネルですべてのモデル呼び出しとツール呼び出しを検査したり、実行ごとのコストを追跡したりできます。
この記事では、AIエージェントデバッガーを使用できるユーザー、サポートされる機能、サポートされない機能、有効化する方法、および既存のApidogプロジェクトがどう変わらないかについて説明します。
利用可能なもの
AIエージェントデバッガーは、標準のApidogクライアントに搭載されています。別途ライセンス、アドオンプラン、シートごとの料金は一切かかりません。
- 無料、Basic、Professional、EnterpriseのすべてのプランにAIエージェントデバッガーが含まれています。
- この機能はデフォルトで有効になっており、切り替える必要はありません。
- 最新のApidogクライアントバージョンを使用している必要があります。古いクライアントにはAIエージェントデバッガータブがありません。
サポートされるモデルプロバイダー
| プロバイダー | ステータス | モデル |
|---|---|---|
| OpenAI | サポート済み | GPT-5.5、GPT-5.5 Instant、o-series、およびOpenAIアカウント上の任意のモデル |
| Anthropic | サポート済み | Claude 4.7 Sonnet、Claude 4.7 Opus、Claude 4.7 Haiku |
| カスタムOpenAI互換エンドポイント | ベースURL上書きでサポート | OpenAI互換APIを公開している任意のプロバイダー |
| その他のプロバイダー(Google、Mistral、xAI) | ロードマップ上 | 現時点ではファーストクラスではありません |
MCPサーバー接続方法
デバッガーはModel Context Protocolをネイティブに話します。3つのトランスポートがサポートされています。
- STDIO. ローカルサブプロセス。活発に開発中のMCPサーバーに最適です。
- HTTPストリーマブル. HTTP経由で到達可能なホスト型MCPサーバー。
- SSE. レガシーなサーバー送信イベント。依然として一般的であり、後方互換性のためにサポートされています。
MCPサーバーの認証は、2つのパターンをカバーします:標準ヘッダー(APIキー)とOAuth 2.0(フルトークン交換)。
デバッガーがカバーするもの
デバッガーは、エージェント実行の完全な実行チェーンをキャプチャします。
- 完全なリクエストとレスポンスペイロードを含むモデル呼び出し。
- モデルが公開している場合(OpenAI o-series、Anthropic拡張思考)のモデル思考トレース。
- パラメーター値とリターンデータを含むツール呼び出し。
- 他のツール呼び出しと同様にトレースパネルにリストされるMCPサーバートラフィック。
- 組み込みツール:
bash、web_fetch、read、edit、write、grep、glob、kill_shell。 - 実行ごとのパフォーマンスメトリック:応答時間、入力トークン、出力トークン、推定コスト。
- スキル:シナリオを再実行するためのシステムプロンプト+ツールリスト+パラメーターの保存済みバンドル。
デバッガーがカバーしないもの
- 本番環境の可観測性。長期的なトラフィックロギングには専用の可観測性ツールを使用してください。
- 自動回帰テスト。フィクスチャに対するプロンプトのグリッドには、Promptfooのようなハーネスを使用してください。
- エージェント間(A2A)プロトコルトラフィック。A2Aには、Apidogの別個のA2Aデバッガーを使用してください。
- 単独でのMCPサーバー検証。エージェントループなしで単一のMCPサーバーのツールとリソースをテストするには、ApidogのMCPサーバーテストフローを使用してください。
有効にする方法
- Apidogを最新バージョンにアップデートします。
- Apidogを開き、上部のタブバーにあるAI Agent Debuggerをクリックします。
- モデルプロバイダーとモデルを選択します。
- ベースURL(プロバイダーから自動入力されます)を確認するか、カスタムエンドポイント用に上書きします。
- APIキーを貼り付けます。
- 空のスレッドで実行をクリックして接続を確認します。
プロジェクトレベルの設定は不要です。デバッガーは独自のワークスペースで実行されます。
変更がないもの
- 既存のApidogプロジェクト、API定義、テストスイートは影響を受けません。
- MCPサーバーテストフローとA2Aデバッガーは並行して動作し続けます。
- APIエンドポイントのデバッグ、モックサーバー、OpenAPI編集は変更されません。
- 課金とプランのティアは変更されません。AIエージェントデバッガーは新しいクレジットを消費しません。
基盤となるモデルAPI呼び出しは、OpenAIまたはAnthropicアカウントで請求されるものに応じて支払われます。Apidogは使用量に対する追加料金を請求しません。
チームおよびEnterprise管理者向け
- AIエージェントデバッガーはユーザーごとに有効になります。各メンバーは独自のプロバイダーAPIキーを使用します。
- デバッガーに入力されたAPIキーは、各ユーザーのクライアントにローカルに保存されます。それらはApidogサーバーには送信されません。
- ワークスペースのオーナーは、標準のApidog環境変数を介して共有MCPサーバーエンドポイントを一元的に管理できます。
- MCPサーバーの監査およびアクセス制御は、MCPサーバー自身の認証モデル(ヘッダーまたはOAuth 2.0)に従います。
既知の制限事項
- OpenAIとAnthropic以外のプロバイダーへの拡張はロードマップ上にあります。それまでは、OpenAI互換プロバイダーにはベースURLの上書きを使用してください。
- トレースの共有はローカルのみです。トレースを共有するには、RawビューのJSONをコピーするか、パネルをスクリーンショットしてください。
- コスト見積もりは、公開されているモデルの価格に基づいたローカルの近似値です。請求については、プロバイダーの使用状況ダッシュボードを参照してください。
