メインコンテンツまでスキップ

A2A 接続ガイド

最終更新 2026/11/05

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 を外部プラットフォームに接続する​

  1. Agent ページに進みます。デフォルト Agent を呼び出す場合は、ページ上部の A2A 1.0 に対応 · 接続方法を見る をクリックします。特定の Agent を呼び出す場合は、その Agent の詳細を開き、外部からの呼び出し(A2A) を探します。
  2. URL をコピー をクリックして、該当する Agent の Card URL を取得します。デフォルト Agent と特定の Agent では URL が異なるため、実際に呼び出す Agent に表示されている URL をコピーしてください。
  3. 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 に接続する​

  1. MCP ページに進み、MCP を追加 をクリックします。
  2. ページに表示される選択肢から 個人 MCP を選択します。
  3. 接続方法を選択 で 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 に関連付けて呼び出しを検証する​

  1. Agent ページで Agent を新規作成するか、管理権限を持つ Agent を編集します。
  2. MCP サービス の設定ステップで、先ほど作成した A2A リモート Agent 接続を探して選択し、Agent を保存します。その接続が有効になっていることを確認してください。
  3. その Agent で新しいセッションを開始し、どのリモート Agent に何のタスクを委任するかをリクエストで明示します。
  4. 実行過程を確認し、リモート 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 の接続設定をそのまま使用することはできません。添付ファイルの転送やストリーミング応答などの機能は、双方が実際に対応し、宣言している機能によって異なります。まずテキストタスクで接続を検証することを推奨します。

このページは役に立ちましたか?