Phase 16: Multi-Agent & Swarms

A2A O Protocolo Agente a Agente

Type: Learn + Build

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

Prerequisites: Phase 16 · 04 (Primitive Model)

Time: ~75 minutes

Problemas

O seu agente precisa chamar outro agente em outro sistema. Como? Você pode expor um endpoint HTTP, definir um esquema JSON personalizado, e esperar que o outro lado fale. Cada par de agentes se torna uma integração personalizada.

A2A é o protocolo universal para essa chamada. Descoberta padrão, modelo de tarefa padrão, transporte padrão, artefatos padrão.

Conceptos

Os quatro elementos

Agent Card.Um documento JSON em /.well-known/agent-card.jsonDescrição do agente: nome, competências,supportedInterfaces(URL do ponto final, ligação de protocolo, versão do protocolo), tipos de mídia de entrada e saída padrão e requisitos de auth (securitySchemes- E mais .securityRequirementsA descoberta acontece lendo o cartão.

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.Uma unidade de trabalho, um objeto sincronizado, com um ciclo de vida:TASK_STATE_SUBMITTED→ TASK_STATE_WORKING→ TASK_STATE_COMPLETED- Não .TASK_STATE_FAILED- Não .TASK_STATE_CANCELEDUm cliente envia uma mensagem, o servidor cria a tarefa e o cliente vota ou subscreve para atualizações.

Artifact.O tipo de resultado produzido por uma tarefa. Texto, JSON estruturado, imagem, vídeo, áudio.text- Não .raw- Não .url, ou datae pode nomear o seu mediaType, por isso diferentes modalidades são de primeira classe.

Opaque lifecycle.A A2A não prescreve como o agente remoto resolve a tarefa. O cliente vê transições de estado e artefatos; a implementação é livre de usar qualquer framework.

A divisão MCP/A2A

• MCP(Lessão 13): agente ferramenta. O agente lê/escreve através de JSON-RPC para um servidor de ferramentas.
• A2AO protocolo de pares, ambos os lados são agentes com o seu próprio raciocínio.

Os sistemas de produção multi-agentes usam ambos. Um par A2A chama ferramentas MCP de seu lado. A divisão mantém as duas preocupações limpas.

Fluxo de descoberta

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

Estas são as rotas de ligação HTTP+JSON, e cada solicitação carrega A2A-Version: 1.0Por padrão .SendMessagebloqueia até que a tarefa atinja um estado terminal ou interrompido, de modo que um cliente de pesquisa define configuration.returnImmediatelyPara recuperar a tarefa de uma vez.

Ou com streaming: POST /message:streamRetorna Eventos enviados pelo servidor (a taskPrimeiro, depois.statusUpdateE ...artifactUpdateeventos), e /tasks/{id}:subscribeO fluxo de transmissão se fecha quando a tarefa atinge um estado terminal; não há final- Não.

Autor

A A2A suporta três padrões comuns:

• Bearer token: OAuth2 ou opaco (httpAuthSecuritySchemeou oauth2SecurityScheme)).
• mTLSA Comissão Europeia (UE)mtlsSecurityScheme)).
• API key: uma chave num cabeçalho, parâmetro de consulta ou cookie (apiKeySecurityScheme)).

A autenticidade é declarada no cartão de agente: securitySchemesnomear cada regime e securityRequirementsDiz quais os clientes devem satisfazer.

150+ organizações até abril de 2026

A adoção da empresa impulsionou a escala A2A. O título: A2A tornou-se a forma como os sistemas de agentes empresariais cruzaram as fronteiras de confiança. O Google Cloud enviou o suporte Vertex AI Agent Builder A2A; o Microsoft Agent Framework o suporta; a maioria das principais frameworks (LangGraph, CrewAI, AutoGen) enviam adaptadores A2A.

Onde A2A ganha

• Cross-organization calls.Agente da empresa A chama agente da empresa B. Sem A2A, cada par é um contrato feito sob medida.
• Heterogeneous frameworks.O agente LangGraph chama o agente CrewAI chama o agente Python personalizado.
• Typed artifacts.Resultado de vídeo, JSON estruturado, áudio todos de primeira classe.
• Long-running tasks.O ciclo de vida opaco + pesquisas tornam as tarefas de horas simples.

Onde A2A luta

• Latency-sensitive micro-calls.O ciclo de vida do A2A é assíncrono. Sub-milissegundos agente-a-agente não se encaixa; usar RPC direto.
• Tight-coupled in-process agents.Se ambos os agentes executarem no mesmo processo Python, a viagem de ida e volta HTTP do A2A é exagerada.
• Small teams.Os custos gerais das especificações são reais; os agentes internos só podem não precisar da formalidade.

A2A vs ACP, ANP, NLIP

Várias especificações relacionadas surgiram em 2024-2026:

• ACP(IBM/Linux Foundation) antecessor do A2A, escopo mais estreito.
• ANP(Protocolo de Rede de Agentes) Peer-discovery-heavy, descentralizado-first.
• NLIP(Protocolo de Interação da Língua Natural da Ecma, padronizado em dezembro de 2025) tipo de conteúdo em língua natural.

A2A é o protocolo de pares mais adotado em abril de 2026. Veja arXiv:2505.02279 (Liu et al., "Um levantamento de protocolos de interoperabilidade de agentes") para comparação.

Construí-lo

code/main.pyimplementa um servidor e cliente A2A-minimal usando http.servere JSON, na ligação HTTP + JSON 1.0.

• expõe/.well-known/agent-card.json- Não .
• Aceita .POST /message:send- Não .
• gerencia o estado da tarefa,
• Retorna artefatos em GET /tasks/{id}- Não .

O cliente:

• - Vai buscar o cartão de agente.
• Envia uma mensagem com returnImmediately- Não .
• sondagens até à conclusão,
• - Ele lê o artefato.

• Correr .

Copypython3 code/main.py

O script inicia o servidor em um fio de fundo, e depois corre o cliente contra ele.

Usá-lo

outputs/skill-a2a-integrator.mdDesenha uma integração A2A: conteúdo do Cartão de Agente, esquemas de tarefas, escolha de autor, streaming versus sondagens.

Envia-o

Lista de verificação:

• Pin the spec version.A2A ainda está a evoluir; cada supportedInterfacesA entrada declara o seu protocolVersion, e os clientes enviamA2A-Version: 1.0- Não .
• Idempotent task creation.As submissões duplicadas (retemps de rede) devem produzir uma tarefa.messageId- Não .
• Artifact schemas.Declare quais são as formas que o agente retorna; os consumidores devem validar.
• Rate limits + auth.A2A é de uso público; aplica segurança web padrão.
• Dead-letter for failed tasks.Inspeccionar os padrões ao longo do tempo para detectar tipos de falhas recorrentes.

Exercícios

1. Corra .code/main.pyConfirme que o cliente descobre o servidor e recebe o artefato correto.
2. Adicionar uma segunda habilidade ao servidor (por exemplo, "resumir"). Atualizar o Cartão de Agente. Escrever um cliente que escolhe a habilidade com base no tipo de tarefa. Uma solicitação 1.0 não tem campo de habilidade, então o servidor percorre as partes de mensagem.
3. Implementação POST /message:stream: resposta com Eventos enviados pelo servidor (a taskPrimeiro, depois.statusUpdateO cliente precisa fazer o que de diferente?
4. Leia a especificação A2A (https://a2a-protocol.org/latest/specification/O artigo 1.o, n.o 1, do Regulamento (CE) n.o 1069/2009 estabelece as regras aplicáveis às empresas que não utilizam a tecnologia.
5. Compare A2A (Agent Card discovery) com MCP (Listing of Server-side capabilities via listToolsO que é a compensação entre agentes que se descrevem e testes de capacidade?

Termos-chave

Mais leitura

• A2A specification a especificação canónica
• A2A v1.0.1 release: os marcados docs/specification.mdE ...specification/a2a.protoEsta lição segue
• Google Developers Blog — A2A announcement Abril de 2025
• A2A GitHub repo Implementações de referência e KDS
• Liu et al. — A Survey of Agent Interoperability Protocols Comparar MCP, ACP, A2A, ANP

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.