Über den Agent 2 Agent-Connector

Integration Service-Connector für das Agent2Agent-Protokoll (A2A), das zum Aufrufen von Remote-A2A-Agents von UiPath Maestro und zur Authentifizierung von in Agent Gateway registrierten Remote-Agents verwendet wird.

Mit dem Connector Agent 2 Agent kann die UiPath-Plattform Remote-Agents aufrufen, die das Protokoll Agent2Agent (A2A) implementieren. A2A ist ein offenes Protokoll für die Kommunikation zwischen KI-Agents, sodass ein Connector Agents erreichen kann, die auf verschiedenen Plattformen basieren und von verschiedenen Anbietern gehostet werden.

Hinweis:

Der Agent 2 Agent-Connector befindet sich in der Vorschau.

Möglichkeiten zur Verwendung des Connectors

Eine Agent 2 Agent-Verbindung kann einen Remote-Agent auf zwei Arten aufrufen:

Wo	Wie die Verbindung verwendet wird
MaestroTM	Mit der Aktivität „Invoke an Agent“ wird der Agent über die Aktion „Starten und auf externen Agenten warten“ aufgerufen. Der Agent nimmt wie jede andere Aufgabe am Prozess teil, und seine Antwort steht den folgenden Schritten zur Verfügung.
Agent-Gateway	Die Verbindung authentifiziert Aufrufe an einen Remote-Agent, der unter Agent Gateway > A2A Agents registriert ist. Alle sieben Authentifizierungstypen werden unterstützt und Agent Gateway liest die Anmeldeinformationen bei jedem Aufruf aus der Verbindung. Der registrierte Agent kann in Maestro-Flows, BPMN-Prozessen von Maestro und mit Agent Builder erstellten Agents verwendet werden. Weitere Informationen finden Sie unter Ausgehend (UiPath zu extern).

Authentication

Jede Verbindung verweist auf einen Remote-Agent. Der Connector unterstützt sieben Authentifizierungstypen, sodass er dem vom Agent deklarierten Sicherheitsschema entsprechen kann. Weitere Informationen finden Sie unter Agent 2 Agent-Authentifizierung.

Events

Der Connector verwendet das Ereignis InvokeAgent Task abgeschlossen, um zu erkennen, wann eine Agent-Aufgabe mit langer Ausführungszeit abgeschlossen ist. Weitere Informationen finden Sie unter Agent 2 Agent-Ereignisse.

Aktivitäten

Sie können die Verbindung verwenden, um die Aktivität Invoke an Agent zu aktivieren. Weitere Informationen finden Sie unter Über die Agent 2 Agent-Aktivitäten.

Anforderungen an Remote-Agents

Die folgenden Anforderungen gelten, wenn Sie den Agent mit der Aktivität Invoke an Agent aufrufen. Für Agents, die im Agent Gateway registriert sind, lesen Sie stattdessen die Anforderungen für Agent Gateway .

Die Aktivität ruft den Agent über den HTTP+JSON (REST)-Transport des A2A-Protokolls auf. Alle Pfade sind relativ zur Dienst-URL der Verbindung. Der Remote-Agent muss folgende Anforderungen erfüllen:

Anforderungen	Details
Agent-Karte	Ohne Authentifizierung an /.well-known/agent-card.json bereitgestellt. Der Connector liest es, um die Verbindung zu validieren, die Verbindung nach dem Agent zu benennen und die Fähigkeiten des Agents aufzulisten.
HTTP+JSON-Transport	Der Agent akzeptiert Nachrichten unter POST /v1/message:send. Agents, die nur den JSON-RPC-Transport verfügbar machen, werden nicht unterstützt.
Antwortumschlag	Die Antwort auf message:send wird in ein message -Objekt für eine sofortige Antwort oder in ein task -Objekt für langlaufende Arbeit eingebettet.
Endpunkt des Aufgabenstatus	Bei Arbeit mit langer Ausführungszeit gibt der Agent die Aufgabe unter GET /v1/tasks:get?id={id} zurück.
Aufgabenstatus	Die Aufgabe status.state verwendet die Statuswerte aus der A2A-Spezifikation. Während der Status TASK_STATE_SUBMITTED, TASK_STATE_WORKING oder TASK_STATE_UNSPECIFIED ist, wird die Aufgabe als in Bearbeitung betrachtet. Jeder andere Status schließt die Aufgabe ab.