エージェント 2 エージェント コネクタについて

Integration Service の Agent2Agent (A2A) プロトコル用コネクタ。UiPath Maestro からリモート A2A エージェントを呼び出し、Agent Gateway に登録されているリモート エージェントを認証するために使用します。

Agent 2 Agent コネクタを使用すると、UiPath Platform は Agent2Agent (A2A) プロトコルを実装するリモート エージェントを呼び出すことができます。A2A は AI エージェント間の通信のためのオープン プロトコルであるため、1 つのコネクタで、異なるプラットフォーム上に構築され、異なるベンダーによってホストされているエージェントにアクセスできます。

注:

Agent 2 Agent コネクタはプレビュー版です。

コネクタの使用方法

Agent 2 Agent 接続は、次の 2 つの方法でリモート エージェントを呼び出すことができます。

場所	コネクションの使用方法
MaestroTM	[ エージェントを呼び出し ] アクティビティは、[ 外部エージェント タスクを開始して待機 ] アクションを通じてエージェントを呼び出します。エージェントは他のタスクと同じようにプロセスに参加し、その応答を以降のステップで利用可能です。
Agent Gateway	この接続は、 Agent Gateway > A2A Agents に登録されているリモート エージェントへの呼び出しを認証します。7 種類の認証すべてがサポートされ、Agent Gateway は呼び出しごとにコネクションから資格情報を読み取ります。登録済みエージェントは、Maestro フロー、Maestro BPMN プロセス、および Agent Builder で構築されたエージェントで使用できます。詳しくは、「 アウトバウンド (UiPath から外部へ)」をご覧ください。

認証

各接続は 1 つのリモート エージェントを指します。コネクタは 7 種類の認証をサポートしているため、エージェントによって宣言されたセキュリティ スキームに一致できます。詳しくは、「 Agent 2 Agentの認証」をご覧ください。

イベント

コネクタは、 InvokeAgent Task Completed イベントを使用して、長期実行のエージェント タスクが完了したタイミングを検出します。詳しくは、「 Agent 2 Agent イベント」をご覧ください。

Activities (アクティビティ)

コネクションを使用して [ エージェントを呼び出し ] アクティビティを有効化できます。詳しくは、「 Agent 2 Agent アクティビティについて」をご覧ください。

リモート エージェントの要件

[ エージェントを呼び出し ] アクティビティを使用してエージェントを呼び出す場合、次の要件が適用されます。Agent Gateway に登録されているエージェントについては、代わりに Agent Gateway の要件 をご覧ください。

このアクティビティは、A2A プロトコルの HTTP+JSON (REST) トランスポートを介してエージェントを呼び出します。すべてのパスは、接続の サービス URL を基準にした相対パスです。リモート エージェントは、次の要件を満たしている必要があります。

要件	詳細
エージェント カード	認証なしで /.well-known/agent-card.json で提供されます。コネクタはそれを読み取って、コネクションを検証し、コネクションにエージェントにちなんで名前を付け、エージェントのスキルのリストを作成します。
HTTP+JSON トランスポート	エージェントは POST /v1/message:sendでメッセージを受け入れます。JSON-RPC トランスポートのみを公開するエージェントはサポートされていません。
返信エンベロープ	message:send への応答は、即時応答の場合は message オブジェクトにラップされ、長期実行の作業の場合は task オブジェクトにラップされます。
タスクのステータス エンドポイント	長期実行の作業の場合、エージェントは GET /v1/tasks:get?id={id}にタスクを返します。
タスクのステート	タスク status.state では、A2A 仕様の状態値が使用されます。ステートが TASK_STATE_SUBMITTED、 TASK_STATE_WORKING、または TASK_STATE_UNSPECIFIEDの場合、タスクは進行中と見なされます。それ以外のステートはタスクを完了します。