Phase 16: Multi-Agent & Swarms

A2A Le protocole agent-agent

Type: Learn + Build

Languages: Python (stdlib, http.server, json)

Prerequisites: Phase 16 · 04 (Primitive Model)

Time: ~75 minutes

Problème

Vous pouvez exposer un point d'extrémité HTTP, définir un schéma JSON sur mesure, et espérer que l'autre côté parle. Chaque paire d'agents devient une intégration personnalisée.

A2A est le protocole de communication universel pour cet appel. Découverte standard, modèle de tâche standard, transport standard, objets standard. Comme HTTP+REST mais pour les agents en tant que citoyens de première classe.

Concept

Les quatre éléments

Agent Card.Un document JSON à /.well-known/agent-card.jsondécrire l'agent: nom, compétences, supportedInterfaces(URL de point final, liaison du protocole, version du protocole), types de médias d'entrée et de sortie par défaut, et exigences d'auth (securitySchemesplus securityRequirementsLa découverte se fait en lisant la carte.

httpCopyGET /.well-known/agent-card.json HTTP/1.1
Host: agent.example.com

jsonCopy{
  "name": "code-review-agent",
  "description": "Reviews Python and TypeScript code.",
  "version": "1.0.0",
  "supportedInterfaces": [
    {
      "url": "https:TOK0
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    }
  ],
  "capabilities": {"streaming": false, "pushNotifications": false},
  "securitySchemes": {
    "bearer": {"httpAuthSecurityScheme": {"scheme": "Bearer"}}
  },
  "securityRequirements": [{"schemes": {"bearer": {"list": []}}}],
  "defaultInputModes": ["text/plain", "application/json"],
  "defaultOutputModes": ["application/json"],
  "skills": [
    {
      "id": "review-python",
      "name": "Review Python",
      "description": "Reviews Python code.",
      "tags": ["code-review", "python"]
    },
    {
      "id": "review-typescript",
      "name": "Review TypeScript",
      "description": "Reviews TypeScript code.",
      "tags": ["code-review", "typescript"]
    }
  ]
}

Task.Un objet asynchrone, étalé avec un cycle de vie:TASK_STATE_SUBMITTED- Je suis là.TASK_STATE_WORKING- Je suis là.TASK_STATE_COMPLETED- Je suis là .TASK_STATE_FAILED- Je suis là .TASK_STATE_CANCELEDUn client envoie un message, le serveur crée la tâche, et le client vote ou s'abonne aux mises à jour.

Artifact.Le type de résultat produit par une tâche. texte, JSON structuré, image, vidéo, audio.text- Je suis là .raw- Je suis là .urlou dataet peut nommer son mediaType, donc les différentes modalités sont de première classe.

Opaque lifecycle.A2A ne précise pas comment l'agent à distance résout la tâche.Le client voit les transitions d'état et les artefacts; la mise en œuvre est libre d'utiliser n'importe quel cadre.

Le MCP/A2A est divisé

• MCP(Léction 13): agent outil. L'agent lit/écrit via JSON-RPC à un serveur d'outils.
• A2ALe protocole de parité; les deux parties sont des agents avec leur propre raisonnement.

Les systèmes de production multi-agents utilisent les deux. un paire A2A appelle les outils MCP de son côté. La division garde les deux problèmes propres.

Flux de découverte

sequenceDiagram
    participant C as Client
    participant S as Agent server
    C->>S: GET /.well-known/agent-card.json
    S-->>C: Agent Card JSON
    C->>S: POST /message:send (returnImmediately)
    S-->>C: task, TASK_STATE_SUBMITTED
    C->>S: GET /tasks/{id}
    S-->>C: TASK_STATE_WORKING
    C->>S: GET /tasks/{id}
    S-->>C: TASK_STATE_COMPLETED, artifacts

Ce sont les routes de liaison HTTP+JSON, et chaque requête est accompagnée A2A-Version: 1.0- Par défaut .SendMessagebloquements jusqu'à ce que la tâche atteigne un état terminal ou interrompu, de sorte qu'un client de sondage définit configuration.returnImmediatelypour récupérer la tâche immédiatement.

Ou avec le streaming: POST /message:streamrenvoie les événements envoyés par le serveur (a taskD'abord, puisstatusUpdateet artifactUpdateévénements), et /tasks/{id}:subscribeLe flux se ferme lorsque la tâche atteint un état terminal; il n'y a pas de finalLe drapeau.

Autre

A2A prend en charge trois modèles communs:

• Bearer token: OAuth2 ou opaque (httpAuthSecuritySchemeou oauth2SecurityScheme)
• mTLS: TLS mutuel; les organisations se prouvent l'identité (mtlsSecurityScheme)
• API key: une clé dans un en-tête, un paramètre de requête ou un cookie (apiKeySecurityScheme)

L' authenticité est déclarée dans la carte d' agent: securitySchemesnom de chaque régime et securityRequirementsLes clients découvrent et se conforment.

150 organisations d'ici à avril 2026

L'adoption par l'entreprise a conduit à l'échelle A2A. Le titre: A2A est devenu la façon dont les systèmes d'agents d'entreprise traversent les frontières de la confiance. Google Cloud a livré le support Vertex AI Agent Builder A2A; Microsoft Agent Framework le prend en charge; la plupart des principaux frameworks (LangGraph, CrewAI, AutoGen) expédient des adaptateurs A2A.

Où A2A gagne

• Cross-organization calls.L'agent de la compagnie A appelle l'agent de la compagnie B. Sans A2A, chaque paire est un contrat sur mesure.
• Heterogeneous frameworks.L'agent LangGraph appelle l'agent CrewAI appelle l'agent Python personnalisé.
• Typed artifacts.Résultat vidéo, JSON structuré, audio tout premier niveau.
• Long-running tasks.Le cycle de vie opaque + les sondages simplifient les tâches d'une durée d'une heure.

Où A2A lutte

• Latency-sensitive micro-calls.Le cycle de vie de l'A2A est asynchrone.
• Tight-coupled in-process agents.Si les deux agents fonctionnent dans le même processus Python, le retour HTTP d'A2A est exagéré.
• Small teams.Les frais généraux sont réels; les agents internes ne peuvent avoir besoin de la formalité.

A2A contre ACP, ANP, NLIP

Plusieurs spécifications connexes ont été émises en 2024-2026:

• ACP(IBM/Linux Foundation) Prédécesseur à A2A, portée plus étroite.
• ANP(Protocole de réseau d'agents) Peer-discovery-heavy, décentralisé-first.
• NLIP(Protocole d'interaction linguistique naturelle ECMA, normalisé décembre 2025) type de contenu en langue naturelle.

A2A est le protocole de pairs le plus adopté en avril 2026. Voir arXiv:2505.02279 (Liu et coll., "Un sondage des protocoles d'interopérabilité des agents") pour la comparaison.

Faites-le

code/main.pymet en œuvre un serveur et un client A2A minimaux en utilisant http.serveret JSON, sur la liaison HTTP + JSON 1.0. Le serveur:

• exposés /.well-known/agent-card.json- Je suis désolé .
• accepte POST /message:send- Je suis désolé .
• gère l'état des tâches,
• retourne des objets sur GET /tasks/{id}- Je suis désolé .

Le client:

• Il vient chercher la carte d'agent,
• envoie un message avec returnImmediately- Je suis désolé .
• les sondages jusqu'à leur fin,
• Il lit l'artefact.

Je vais courir .

Copypython3 code/main.py

Le script démarre le serveur dans un fil d'arrière-plan, puis le client contre lui. Vous voyez le flux complet: découverte, soumission, sondage, artefact.

Utilisez-le

outputs/skill-a2a-integrator.mdIl propose une intégration A2A: contenu de la carte d'agent, schémas de tâches, choix d'auteur, streaming et sondage.

La faire partir

Liste de contrôle:

• Pin the spec version.A2A est toujours en évolution; chaque supportedInterfacesl' entrée déclare son protocolVersion, et les clients envoientA2A-Version: 1.0- Je suis désolé .
• Idempotent task creation.Les répétitions de données (réessayes réseau) doivent produire une seule tâche.messageId- Je suis désolé .
• Artifact schemas.Déclarer les formes que le vendeur retourne; les consommateurs doivent valider.
• Rate limits + auth.A2A est ouvert au public; appliquez la sécurité Web standard.
• Dead-letter for failed tasks.Inspecter les modèles au fil du temps pour les types de défaillances récurrentes.

Exercices

1. On court .code/main.pyConfirmez que le client découvre le serveur et reçoit l'artefact correct.
2. Ajouter une deuxième compétence au serveur (par exemple, " résumer "). Mise à jour la carte d'agent. Écrivez un client qui choisit la compétence en fonction du type de tâche. Une requête 1.0 n'a pas de champ de compétence, donc le serveur route sur les parties du message.
3. Mise en œuvre POST /message:stream: réponse avec les événements envoyés par le serveur (a taskD'abord, puisstatusUpdateLes clients doivent-ils faire différemment?
4. Lire la spécification A2A (https://a2a-protocol.org/latest/specification/) Identifier trois éléments que les spécifications ne mettent pas en œuvre dans cette démo.
5. Comparez A2A (découverte de carte d' agent) à MCP (liste de capacités côté serveur via listToolsQuelle est la différence entre les agents qui se décrivent eux-mêmes et ceux qui testent leurs capacités?

Les termes clés

Pour en savoir plus

• A2A specification la spécificité canonique
• A2A v1.0.1 release: les étiquettes docs/specification.mdet specification/a2a.protoCette leçon suit
• Google Developers Blog — A2A announcement Le lancement en avril 2025
• A2A GitHub repo Implémentations de référence et KDD
• Liu et al. — A Survey of Agent Interoperability Protocols Comparaison des PAM, ACP, A2A, PAN

This free lesson is part of the AI Engineering from Scratch curriculum. Read the full explanation, run the lesson code, and verify the result in the interactive reader or from the repository source.

Browse the complete course catalog or open this lesson on GitHub.