A2A 接続ガイド
A2A は、異なるプラットフォームの Agent を接続するための仕組みです。外部プラットフォームから AE Agent を呼び出すことも、AE にリモート Agent を接続して、現在の Agent からタスクの実行を委任し、結果をまとめることもできます。
機能の概要と事前準備
| 接続の方向 | 適用シナリオ | 設定の入口 |
|---|---|---|
| 外部プラットフォームから AE Agent を呼び出す | A2A に対応する他のプラットフォームで、AE Agent の機能を使用します。 | AE の Agent ページで Agent Card の URL を取得し、呼び出し機能を持つ外部 Agent のセッション、または A2A の設定ページから接続します。 |
| AE からリモート Agent を呼び出す | 現在の Agent から専門的なタスクの処理をリモート Agent に委任します。 | MCP ページで「A2A リモート Agent」を追加し、対象の AE Agent に関連付けます。 |
Agent Card は、Agent の名前、機能、プロトコル、呼び出し先の URL を記述する情報ファイルです。接続時には完全な Agent Card URL を入力し、呼び出し元からその URL と Card に記載されたサービス URL にアクセスできることを確認してください。
接続には、A2A 1.0 JSON-RPC と互換性のあるクライアントまたはリモートサービスが必要です。AE Agent を呼び出す場合は、その Agent にアクセスする権限を持つ有効な TE access token を用意し、対象の Agent を有効にしてください。他のプラットフォームのリモート Agent に接続する場合は、そのサービスの Bearer Token を用意してください。
AE Agent を外部プラットフォームに接続する
- Agent ページに進みます。デフォルト Agent を呼び出す場合は、ページ上部の A2A 1.0 に対応 · 接続方法を見る をクリックします。特定の Agent を呼び出す場合は、その Agent の詳細を開き、外部からの呼び出し(A2A) を探します。
- URL をコピー をクリックして、該当する Agent の Card URL を取得します。デフォルト Agent と特定の Agent では URL が異なるため、実際に呼び出す Agent に表示されている URL をコピーしてください。
- HTTP リクエストを実行し、A2A 1.0 プロトコルに従って呼び出すことができる外部 Agent のセッションに、Card URL とタスクを送信します。プラットフォームが提供する A2A 接続設定ページを使用することもできます。Card の読み取りと、その後のタスクリクエストのどちらにも、次のリクエストヘッダーが必要です。
Authorization: Bearer <TE_ACCESS_TOKEN>
A2A-Version: 1.0
<TE_ACCESS_TOKEN> を有効な TE access token に置き換えてください。このトークンは既存の認証方法で取得します。A2A 接続ウィンドウではトークンを生成しません。Card URL をコピーするだけでは認証できず、ブラウザーの Cookie を上記のリクエストヘッダーの代わりに使用することもできません。
セッションから依頼する場合は、次の指示に、先ほどコピーした完全な Card URL を添えて送信できます。
この Agent Card を読み取り、設定済みの TE アクセス認証情報を使って、A2A 1.0 プロトコルに従い、この Agent を呼び出してください。タスクは、「キャンペーンは今週金曜日に開仕します。ぜひご参加ください。」を誤字のない文章に修正することです。
外部 Agent は、実際に Card を読み取り、プロトコルに従ったリクエストを送信する必要があります。通常のチャット画面でリンクとテキストを受信しただけでは、A2A 接続が確立されたことにはなりません。プラットフォームにリクエストを実行するツールがない場合は、そのプラットフォームが対応する A2A 接続方法を使用してください。
初回は、簡単なテキストタスクで検証してください。実行中のタスクが返された場合は、引き続きタスクの状態を確認します。追加の入力が必要な場合は、元のタスクで返信を続けてください。
AE の接続ウィンドウで Card の内容を見る をクリックすると、プロトコル、入出力形式、完全な JSON を確認し、JSON をコピーできます。このプレビューは現在のログインユーザーとして表示されます。外部プラットフォームが別の認証情報を使用する場合は、その認証情報で実際に読み取った Card を基準にしてください。
外部からの呼び出しには、トークンを所有するユーザーの権限が適用されます。そのユーザーに表示され、有効になっている Agent にのみアクセスできます。また、接続先 URL は、外部プラットフォームのネットワークからアクセスできる必要があります。
MCP 経由で A2A リモート Agent に接続する
- MCP ページに進み、MCP を追加 をクリックします。
- ページに表示される選択肢から 個人 MCP を選択します。
- 接続方法を選択 で A2A リモート Agent を選び、次の設定を入力します。
| 構成項目 | 入力説明 |
|---|---|
| サービス名(必須) | copy_editor など、識別しやすい名前を入力します。先頭は英字とし、英字、数字、アンダースコア、ハイフンのみ使用できます。 |
| Agent Card URL(必須) | リモート Agent の完全な A2A 1.0 Card URL を入力します。別の AE Agent に接続する場合は、その Agent の接続ウィンドウからコピーした URL を使用してください。ここには通常の MCP サービス URL ではなく、Card URL を入力します。 |
| Bearer Token(必須) | リモート Agent にアクセスする権限を持つトークンを入力します。トークンのみを入力し、Bearer プレフィックスは付けないでください。AE Agent への接続には、有効な TE access token を使用します。 |
| その他の設定(任意) | 必要に応じて表示名と説明を追加し、利用者がリモート Agent の用途を把握しやすくします。 |
| このアドレスのプライベートネットワークまたは HTTP アクセスを許可(任意) | 既定ではオフです。プライベートネットワークまたは HTTP の URL にアクセスする必要がある場合にのみ有効にしてください。許可されるのは、現在の URL のホストとポートだけです。HTTP では認証情報とデータが平文で送信されるため、HTTPS の使用を推奨します。 |
| リモート実行モデル(任意) | URL とトークンを入力した後、モデル一覧を取得 をクリックし、リモート側で使用を許可されているモデルを選択します。未選択の場合はリモートの既定動作を維持します。 |
リモートモデルの一覧は、現在の接続認証情報のアクセス権限によって異なります。リモート Agent がモデル選択に対応していない場合は、既定動作のままにしてください。選択済みのモデルが無効になった場合は、一覧を再取得して利用可能なモデルを選択するか、既定動作に戻して保存してください。
入力が完了したら MCP を保存 をクリックします。プラットフォームは認証情報を使って Agent Card を読み取り、互換性のある A2A 1.0 JSON-RPC インターフェースが提供されているかを確認します。トークンは暗号化して保存され、リモート Agent へのアクセス時にサーバーで使用されます。
Agent に関連付けて呼び出しを検証する
- Agent ページで Agent を新規作成するか、管理権限を持つ Agent を編集します。
- MCP サービス の設定ステップで、先ほど作成した A2A リモート Agent 接続を探して選択し、Agent を保存します。その接続が有効になっていることを確認してください。
- その Agent で新しいセッションを開始し、どのリモート Agent に何のタスクを委任するかをリクエストで明示します。
- 実行過程を確認し、リモート Agent のツール呼び出しが行われ、結果が返されたことを確認します。リモート側から追加情報を求められた場合は、案内に従って返信を続けてください。
例えば、文章校正用のリモート Agent に接続した場合は、次のように入力できます。
文章校正 Agent を呼び出し、次の文章の誤字を確認して、修正理由を説明してください:キャンペーンは今週金曜日に開仕します。ぜひご参加ください。
Agent の指示に、リモート Agent に適したタスクと期待する出力を記載すると、適切な場面で委任しやすくなります。接続の保存やツール一覧の取得に成功しただけでは、該当する設定やツールの検出が成功したことしか確認できません。初回利用時には、実際に一度委任して結果を検証してください。
よくある質問と制限事項
| 現象 | 確認と対処 |
|---|---|
| Agent Card を読み込めない、または接続の保存に失敗する | 完全な Card URL を入力しているか、トークンが有効か、サービスが A2A 1.0 JSON-RPC インターフェースを提供しているかを確認します。プラットフォームから Card とそこに記載された呼び出し先 URL にアクセスできることを確認してください。プライベートネットワークまたは HTTP の URL を使用する場合は、該当するアクセス許可スイッチを確認します。 |
| 外部プラットフォームで AE Card を読み取るとき、またはタスクを呼び出すときに認証に失敗する | Card の読み取りとタスクリクエストの両方に、Authorization と A2A-Version: 1.0 のリクエストヘッダーが含まれていることを確認します。トークンを所有するユーザーがその Agent にアクセスする権限を持ち、その Agent が有効になっているかも確認してください。 |
| モデル一覧を取得できない、または選択したモデルを利用できない | URL、トークン、リモート側のモデル選択機能を確認します。一覧を再取得し、現在の認証情報で利用可能なモデルを選択してください。モデルを指定しない場合は、リモートの既定動作を維持 を選択します。 |
| A2A Bearer Token を保存できないと表示される | サービスで認証情報の暗号化が設定されていないと表示された場合は、管理者にサービスの設定を依頼してから再試行してください。 |
| 接続を保存したのに Agent がリモート側を呼び出さない | 接続が有効になっており、対象 Agent の MCP サービス で選択されていることを確認します。新しいセッションで、タスクの委任を明示してください。呼び出しは行われたものの実行に失敗した場合は、返された案内に従ってリモートサービス、権限、ネットワークを確認します。必要に応じて、管理者に実行環境の接続性の確認を依頼してください。 |
現在の接続は A2A 1.0 JSON-RPC と Bearer 認証に対応しており、A2A 0.3 とは互換性がありません。通常の MCP、REST、gRPC の接続設定をそのまま使用することはできません。添付ファイルの転送やストリーミング応答などの機能は、双方が実際に対応し、宣言している機能によって異なります。まずテキストタスクで接続を検証することを推奨します。

