Aller au contenu
Retour à Systèmes d'agents et standards

Systèmes d'agents et standards · Chapitre 2 sur 8

A2A : des agents qui délèguent à des agents

Comment un agent en trouve un autre grâce à son Agent Card et lui confie une tâche qu'il peut suivre jusqu'au bout.

25 minutes0 objectifs sur 4 atteints

Objectifs

  • Lisez l'Agent Card de l'agent Payments.À faire
  • Suivez une tâche de WORKING à COMPLETED en passant par INPUT_REQUIRED.À faire
  • Répondez à un id de tâche qui n'est pas le vôtre et voyez la réponse rejetée.À faire
  • Remettez l'échange dans l'ordre.À faire

Étape 1 sur 4 : La lecture

Un pair, pas un outil

A2A (Agent2Agent, protocole 1.0) relie des agents que des parties différentes font tourner. Au chapitre précédent, l'agent de support appelait des outils sur un serveur MCP : des fonctions avec un schéma, exécutées exactement comme elles sont appelées. Avec A2A, il confie du travail à un autre agent, qui décide comment le faire avec son propre modèle, ses outils et sa mémoire. L'appelant ne voit que la tâche et ses résultats.

L'Agent Card

Chaque serveur A2A a une Agent Card. Un agent public la sert à /.well-known/agent-card.json, où n'importe qui peut la lire sans identifiant. Elle nomme l'agent et ses compétences, liste ses interfaces (URL, binding comme JSONRPC, version du protocole), dit s'il peut faire du streaming et déclare comment s'authentifier, ici avec un bearer token par marchand. Chaque requête porte un en-tête A2A-Version ; un serveur refuse une version que sa carte ne liste pas (erreur -32009).

Messages, tâches et artefacts

Le client appelle SendMessage avec un message fait de parties : du texte pour le modèle de l'autre agent, et des parties de données avec un type de média pour les valeurs sur lesquelles il peut compter, comme l'id de la commande et le montant. La réponse est un message ou, pour un travail qui prend du temps, une tâche : un id, un contextId qui regroupe une conversation, et un état comme TASK_STATE_WORKING, INPUT_REQUIRED ou COMPLETED. Les résultats arrivent sous forme d'artefacts sur la tâche, à part de la conversation.

INPUT_REQUIRED met la tâche en pause jusqu'à ce que le client réponde. La réponse est un nouveau message qui nomme les mêmes taskId et contextId. Le serveur sépare les tâches de chaque marchand : une réponse qui nomme une tâche que ce marchand ne possède pas reçoit -32001, task not found, et rien ne s'exécute.

Streaming ou polling

Avec SendStreamingMessage, le serveur pousse des server-sent events : d'abord la tâche, puis les mises à jour d'état et d'artefacts, jusqu'à ce que la tâche se mette en pause ou se termine. Sans streaming, SendMessage répond quand la tâche se met en pause ou se termine ; avec returnImmediately, il répond tout de suite, et le client interroge GetTask.

Ce que vous faites ici

L'agent de support de Halden et l'agent Payments font tous deux tourner le SDK JavaScript officiel d'A2A (@a2a-js/sdk 1.3.0) dans cette page, chacun piloté par un modèle LangChain scripté. Lisez la carte, suivez la tâche de remboursement à travers ses états et répondez vous-même à sa question. Activez ensuite Intercepter et dirigez votre réponse vers la tâche d'un autre marchand. Une étape facultative montre l'agent Payments qui atteint son registre comptable par MCP, où l'input_required de MCP devient l'INPUT_REQUIRED de la tâche A2A.

Étape 2 sur 4 : Essayez : Une tâche qui passe une frontière

Une tâche qui passe une frontière

Trois étapes, une action chacune, puis deux facultatives. Le diagramme sous les étapes a une colonne par participant et une ligne par message, de haut en bas. L'épaisse ligne en tirets est la frontière entre organisations.

Mode :RéelSimuléRéel : le SDK JavaScript d'A2A (@a2a-js/sdk 1.3.0, A2A 1.0), client et serveur, et le SDK MCP de l'étape facultative A2A avec MCP tournent dans cette page. Simulé : les décisions des agents sont scriptées, sauf si vous connectez un modèle, les paiements sont simulés et les données sont fictives.

Étape 3 sur 4 : Vérification

Vérification

Remettez dans l'ordre l'échange A2A du remboursement.

Faites glisser les éléments, ou utilisez les flèches, pour les mettre dans l'ordre.

  1. Position 1 : SendMessage avec la demande de remboursement.
  2. Position 2 : GET de l'Agent Card.
  3. Position 3 : Tâche en TASK_STATE_COMPLETED, avec le reçu du remboursement comme artefact.
  4. Position 4 : SendMessage avec la réponse, sur la même tâche.
  5. Position 5 : Tâche en TASK_STATE_INPUT_REQUIRED.
  6. Position 6 : Tâche en TASK_STATE_WORKING.

Étape 4 sur 4 : Ce que vous savez faire maintenant

Ce que vous savez faire maintenant

  • Lire une Agent Card et choisir une compétence et une interface.
  • Envoyer un message et suivre les états d'une tâche jusqu'à ses artefacts, en streaming ou par polling.
  • Répondre à une tâche en INPUT_REQUIRED avec une réponse sur les mêmes taskId et contextId.
  • Expliquer quand utiliser A2A plutôt que MCP.