本文へスキップ
エージェントシステムと標準に戻る

エージェントシステムと標準 · 第2章(全8章)

A2A:エージェントに任せるエージェント

あるエージェントがAgent Cardを通じて別のエージェントを見つけ、最後まで追えるタスクを渡す方法。

25分4個中0個の目標を達成

目標

  • Payments agentのAgent Cardを読みます。未完了
  • タスクをWORKINGからINPUT_REQUIREDを経てCOMPLETEDまで追います。未完了
  • 自分のものではないタスクidに返信し、拒否されるのを確かめます。未完了
  • やり取りを正しい順に並べます。未完了

ステップ1/4: 本文

ツールではなく対等な相手

A2A(Agent2Agent、プロトコル1.0)は、別々の当事者が動かすエージェント同士をつなぎます。前の章では、サポートエージェントはMCPサーバーのツール、つまりスキーマを持ち呼ばれたとおりに動く関数を呼び出しました。A2Aでは作業を別のエージェントに渡し、そのエージェントが自分のモデル、ツール、メモリでどう進めるかを決めます。呼び出し側に見えるのは、タスクとその結果だけです。

Agent Card

A2Aサーバーにはそれぞれ、Agent Cardがあります。公開エージェントは/.well-known/agent-card.jsonでカードを提供し、誰でも認証情報なしで読めます。カードはエージェントとそのスキルの名前を示し、インターフェース(URL、JSONRPCなどのバインディング、プロトコルバージョン)を並べ、ストリーミングできるかを示し、認証の方法を宣言します。ここでは加盟店ごとのbearerトークンです。各リクエストはA2A-Versionヘッダーを持ち、サーバーはカードにないバージョンを拒否します(エラー-32009)。

メッセージ、タスク、アーティファクト

クライアントは、パートからなるメッセージでSendMessageを呼び出します。相手のモデル向けのテキストと、注文idや金額のように確実に扱える値のための、メディアタイプ付きのデータパートです。応答はメッセージか、時間のかかる作業ではタスクです。タスクは、id、会話をまとめるcontextId、そしてTASK_STATE_WORKING、INPUT_REQUIRED、COMPLETEDのような状態を持ちます。結果はチャットとは別に、タスクのアーティファクトとして届きます。

INPUT_REQUIREDは、クライアントが答えるまでタスクを一時停止します。答えは、同じtaskIdとcontextIdを指定した新しいメッセージです。サーバーは加盟店ごとにタスクを分けて保持します。その加盟店のものではないタスクを指定した返信には-32001(task not found)が返り、何も実行されません。

ストリーミングかポーリングか

SendStreamingMessageでは、サーバーがserver-sent eventsをプッシュします。最初にタスク、次に状態とアーティファクトの更新を、タスクが一時停止するか終わるまで送ります。ストリーミングを使わない場合、SendMessageはタスクが一時停止するか終わったときに応答します。returnImmediatelyを付けるとすぐに応答し、クライアントはGetTaskでポーリングします。

ここですること

HaldenのサポートエージェントとPayments agentは、どちらもこのページで公式のA2A JavaScript SDK(@a2a-js/sdk 1.3.0)を動かし、それぞれ台本どおりのLangChainモデルが操作します。カードを読み、返金タスクを状態ごとに追い、その質問に自分で答えてください。次に「傍受」をオンにし、返信を別の加盟店のタスクに向けます。任意のステップでは、Payments agentがMCPで台帳にアクセスし、MCPのinput_requiredがA2AタスクのINPUT_REQUIREDになる様子が見えます。

ステップ2/4: 試す:境界を越えるタスク

境界を越えるタスク

3つのステップがあり、それぞれ操作は1つで、任意のステップが2つ続きます。ステップの下の図は、参加者ごとに1列、メッセージごとに1行で、上から下へ並びます。太い破線は組織の境界です。

モード:本物シミュレーション本物:A2A JavaScript SDK(@a2a-js/sdk 1.3.0、A2A 1.0)のクライアントとサーバー、そして任意のステップ「A2AとMCP」のMCP SDKが、このページで動きます。シミュレーション:モデルをつながない限り、エージェントの判断は台本どおりで、決済はシミュレーション、データは架空です。

ステップ3/4: 確認問題

確認問題

返金のためのA2Aのやり取りを正しい順に並べてください。

項目をドラッグするか矢印ボタンを使って、正しい順番に並べてください。

  1. 1番目: 返金の依頼をSendMessageで送る。
  2. 2番目: Agent CardをGETする。
  3. 3番目: タスクがTASK_STATE_COMPLETEDになり、返金の受領書がアーティファクトとして付く。
  4. 4番目: 同じタスクに、答えをSendMessageで送る。
  5. 5番目: タスクがTASK_STATE_INPUT_REQUIREDになる。
  6. 6番目: タスクがTASK_STATE_WORKINGになる。

ステップ4/4: これでできること

これでできること

  • Agent Cardを読み、スキルとインターフェースを選べます。
  • メッセージを送り、ストリームかポーリングで、タスクの状態をアーティファクトまで追えます。
  • INPUT_REQUIREDのタスクに、同じtaskIdとcontextIdで返信して答えられます。
  • MCPではなくA2Aを使うべきときを説明できます。