A2A（Agent2Agent）は、Agent 間の通信のためのオープンプロトコルです。A2A を通じて、異なる Agent は互いの機能を検出し、メッセージを送信し、実行結果を返すことができます。A2A Debugger は、A2A Agent をデバッグするためのビジュアルツールです。A2A Agent に接続し、テストメッセージを送信し、Agent が返したコンテンツ、実行ステータス、デバッグログを確認できます。これにより、開発者は Agent の統合、メッセージ配信、返却結果に関する問題を迅速にトラブルシューティングできます。A2A Debugger は、次のようなシナリオに適しています。A2A Agent が正常に接続できるかを確認する
Agent の名前、説明、機能、Skills を確認する
Agent にテキストまたは添付ファイルを送信し、そのレスポンスを検証する
認証、Header、ファイルタイプなど、接続またはリクエストに関する問題をトラブルシューティングする
リクエストとレスポンスの詳細を確認し、異常な返却コンテンツの原因を特定する
AI Agent Debugger のすべての機能を利用するには、最新の Apidog クライアントを使用することをお勧めします。
A2A Agent への接続#
ページ上部に Agent Card URL を入力し、Connect をクリックします。接続に成功すると、上部のステータスが Connected と表示されます。この時点で、Agent 情報を確認し、メッセージの送信を開始できます。別の Agent に切り替える必要がある場合は、Disconnect をクリックしてから、Agent Card URL を再入力できます。テストメッセージの作成#
Messages タブで、Agent に送信するテスト入力を作成します。メッセージ編集エリアは左右のセクションに分かれています。左側：メッセージテキストの入力、添付ファイルのアップロード、Metadata の設定
メッセージの送信#
メッセージ設定が完了したら、Send をクリックします。現在 Agent に接続されていない場合、A2A Debugger はまず接続を試行し、接続に成功した後にメッセージを送信します。送信後、メッセージエリアでユーザーメッセージと Agent が返したコンテンツを確認できます。返信メッセージの確認#
メッセージエリアには、現在のセッションにおけるユーザーメッセージと Agent の返信が表示されます。Agent が返すコンテンツはプレーンテキストの場合もあれば、タスクステータス、実行結果、生成された成果物を含む場合もあります。メッセージ表示エリアを通じて、Agent がリクエストを正しく理解し処理したかをすばやく判断できます。任意のデバッグメッセージをクリックすると、右側に詳細が表示されます。詳細パネルは 3 つのビューをサポートしています。Preview：主要なコンテンツをより読みやすい形式で表示します
Content：メッセージ内のテキストまたはコアデータを確認します
Raw Data：完全な生の JSON を確認します
What is the distance between the Earth and the Moon?
Agent Card の確認#
デバッグパネルの Agent Card タブは、現在接続されている Agent の機能説明を確認するために使用します。Agent のアドレス、プロトコルバージョン、バージョン番号
Agent がサポートする機能（ストリーミングレスポンス、プッシュ通知、ステータス履歴などをサポートしているかどうか）
添付ファイルの追加#
現在の Agent がファイル入力をサポートしている場合、メッセージ入力エリアの下にある添付ボタンをクリックしてファイルをアップロードできます。A2A Debugger は、Agent によって宣言された入力タイプに基づいて、添付ファイルのアップロードが許可されるかどうかを判断します。Agent がテキスト入力のみをサポートしている場合、添付ボタンは使用できません
Agent が特定のファイルタイプのみをサポートしている場合、一致するタイプのファイルのみをアップロードできます
Agent が任意のファイルタイプをサポートしている場合、任意のファイルをアップロードできます
認証の設定#
A2A Agent が認証を必要とする場合、Authentication タブで認証方法を設定できます。| 認証方法 | 説明 |
|---|
| None | 認証情報を追加しません |
| Bearer Token | トークンを使用して認証します |
| Basic Auth | ユーザー名とパスワードを使用して認証します |
| API Key | 指定した Header 経由で API Key を渡します |
メッセージ送信時に未認可エラーが返される場合は、認証方法、トークン、ユーザー名/パスワード、または API Key が正しいかを確認してください。ヘッダーの設定#
Header タブでは、カスタムリクエスト Header を追加できます。カスタム Header は、一般的に次のようなシナリオで使用されます。テナント ID、環境識別子などの業務パラメータを渡す
ゲートウェイ、プロキシ、または内部サービスを通じて認証する
特別なリクエストヘッダーを必要とする Agent サービスをデバッグする
FAQ#
接続に失敗した場合はどうすればよいですか？#
1.
Agent Card URL が正しく、現在の環境からアクセス可能であるか。
3.
認証が必要な場合、Authentication タブで正しい認証情報が設定されているか。
4.
テナント ID、環境識別子、ゲートウェイ認証情報など、追加の Headers が必要かどうか。
5.
Agent Card が返すコンテンツが有効な JSON であるか。
接続に成功した後、添付ファイルをアップロードできない場合は？#
これは通常、現在の Agent がファイル入力のサポートを宣言していない、または特定のファイルタイプのみのアップロードを許可していることが原因です。Agent Card タブで Agent がサポートする入力タイプを確認し、アップロードするファイルタイプが一致しているかを確認してください。完全なリクエストとレスポンスを確認するにはどうすればよいですか？#
デバッグパネルの Messages タブで、対応するリクエストまたはレスポンスログをクリックし、Raw Data ビューに切り替えて完全な JSON を確 認します。Agent が返したコンテンツが異常に表示される場合はどうすればよいですか？#
1.
デバッグメッセージのプレビューコンテンツを確認し、Agent が結果を返しているかを確認します。
2.
Raw Data ビューに切り替えて、完全なレスポンスを確認します。
3.
Agent Card で宣言されている入力タイプ、出力タイプ、Skills が期待どおりかを確認します。
4.
メッセージまたはデバッグ詳細に検証エラーのプロンプトがないか確認します。
