À propos du connecteur d'agent Agent 2

Connecteur Integration Service pour le protocole Agent2Agent, utilisé pour appeler des agents A2A distants depuis UiPath Maestro et pour authentifier les agents distants enregistrés dans Agent Gateway.

Le connecteur Agent 2 Agent permet à la plateforme UiPath d'appeler des agents distants qui implémentent le protocole Agent2Agent. L’A2A est un protocole ouvert de communication entre les agents d’IA. Ainsi, un connecteur peut atteindre des agents créés sur différentes plates-formes et hébergés par différents fournisseurs.

Remarque :

Le connecteur Agent 2 Agent est en aperçu.

Faunes d'utiliser le connecteur

Une connexion Agent 2 Agent peut appeler un agent distant de deux manières:

Où	Comment la connexion est utilisée
MaestroTM	L'activité Invoquer un agent appelle l'agent via l' action Démarrer et attendre l'action de tâche d'agent externe . L'agent prend part au processus comme n'importe quelle autre tâche, et sa réponse est disponible pour les étapes qui suivent.
Passerelle d’agent	La connexion authentifie les appels destinés à un agent distant enregistré dans Agent Gateway > Agents A2A. Les sept types d'authentification sont pris en charge et Agent Gateway lit les informations d'identification de la connexion à chaque appel. L'agent enregistré peut être utilisé dans les flux Maestro, les processus BPMN Maestro et les agents créés avec Agent Builder. Pour plus de détails, consultez la section Sortant (UiPath vers externe).

Authentification

Chaque connexion pointe vers un agent distant. Le connecteur prend en charge sept types d'authentification, il peut donc correspondre au schéma de sécurité déclaré par l'agent. Pour des détails, reportez-vous à Agent 2 Agent authentification.

Events

Le connecteur utilise l'événement InvokeAgent Task Completed pour détecter la fin d'une tâche d'agent de longue durée. Pour de plus amples informations, reportez-vous à la section Agent 2 Agent Events (Événements d'agent).

Activités

Vous pouvez utiliser la connexion pour activer l'activité Appeler un agent . Pour de plus amples informations, consultez la section À propos des activités Agent 2 Agent.

Exigences de l’agent distant

Les exigences suivantes s'appliquent lorsque vous appelez l'agent avec l'activité Invoquer un agent . Pour les agents enregistrés dans Agent Gateway, reportez-vous plutôt aux exigences d’Agent Gateway.

L'activité appelle l'agent via le transport HTTP+JSON du protocole A2A. Tous les chemins sont relatifs à l’ URL de service de la connexion. L'agent distant doit répondre aux exigences suivantes:

Prérequis	Détails (Details)
Carte d’agent	Serveur /.well-known/agent-card.json sans authentification. Le connecteur la lit pour valider la connexion, pour nommer la connexion après l'agent et pour répertorier les compétences de l'agent.
Transport HTTP+JSON	L’agent accepte les messages à POST /v1/message:send. Les agents qui exposent uniquement le transport JSON-RPC ne sont pas pris en charge.
Enveloppe de réponse	La réponse à message:send est encapsulée dans un objet message pour une réponse immédiate ou dans un objet task pour un travail de longue durée.
Point de terminaison du statut de la tâche	Pour un travail de longue durée, l'agent renvoie la tâche à GET /v1/tasks:get?id={id}.
États de la tâche	La tâche status.state utilise les valeurs d'état de la spécification A2A. Lorsque l'état est TASK_STATE_SUBMITTED, TASK_STATE_WORKING ou TASK_STATE_UNSPECIFIED, la tâche est considérée comme en cours. Tout autre état termine la tâche.