Protocolo A2A Explicado: Agent Cards e Indexação no Wellknown

O protocolo A2A, ou Agent2Agent, é um padrão aberto que permite que agentes de IA se descubram e troquem tarefas usando JSON-RPC. O elemento central desse protocolo é o Agent Card, um documento JSON publicado por um agente A2A no caminho /.well-known/agent-card.json. Esse cartão descreve o nome do agente, suas habilidades, URL do endpoint e esquemas de segurança, permitindo que outros agentes e índices entendam e interajam com ele.

Principais pontos

• O protocolo A2A facilita a descoberta de agentes e a troca de tarefas via JSON-RPC.
• O Agent Card fica em /.well-known/agent-card.json no domínio do agente.
• O Agent Card descreve a identidade, capacidades, endpoint e segurança do agente.
• O Wellknown indexa 2.749 registros do protocolo A2A, com 2.153 atualmente ativos.
• Agentes são submetidos ou encontrados no índice do Wellknown por auto-submissão ou descoberta dos seus Agent Cards.

O que é o protocolo A2A?

O protocolo A2A significa Agent2Agent. É um protocolo aberto criado para permitir que agentes de IA se descubram e troquem tarefas. Os agentes publicam um documento JSON padronizado chamado Agent Card em um local conhecido no seu domínio. A comunicação entre agentes ocorre via JSON-RPC, um protocolo de chamada remota de procedimento codificado em JSON.

Esse protocolo permite que agentes encontrem pares dinamicamente e colaborem enviando tarefas e respostas de forma estruturada. Ele é distinto de outros protocolos como o MCP (Model Context Protocol), que foca em conectar aplicações de IA a ferramentas e dados.

O que é um Agent Card e onde ele fica?

Um Agent Card é um documento JSON que um agente A2A publica no caminho /.well-known/agent-card.json em seu domínio. Essa localização é padronizada para que outros agentes e índices saibam onde procurá-lo.

O Agent Card descreve:

• O nome do agente
• As habilidades ou capacidades do agente
• A URL do endpoint onde o agente pode ser contatado
• Os esquemas de segurança que o agente suporta

Ao fornecer essas informações, o Agent Card possibilita a descoberta e interação com o agente. Ele funciona como uma auto-descrição que índices como o Wellknown podem ler para listar e categorizar agentes.

Como o Wellknown lê e indexa os Agent Cards?

O Wellknown é um índice ativo de agentes de IA, servidores MCP e ferramentas que verifica constantemente seus endpoints. Ele lê os Agent Cards buscando o documento JSON em /.well-known/agent-card.json no domínio do agente. Isso permite extrair metadados declarados sobre o agente, como nome, habilidades e endpoint.

O Wellknown separa os metadados declarados (o que o publicador informa) dos dados observados (o que o Wellknown mede ao verificar o endpoint). Isso garante transparência sobre a disponibilidade e confiabilidade atual do agente.

Quantos registros A2A o Wellknown possui e quantos estão ativos?

Até o último snapshot de dados em 2026-10-31, o Wellknown possui 2.749 registros para o protocolo A2A. Destes, 2.153 estão atualmente ativos, ou seja, sua última verificação foi bem-sucedida nas últimas 24 horas. Isso indica um alto nível de agentes A2A ativos e acessíveis na rede.

Para comparação, o tamanho total do índice do Wellknown é de 79.658 registros, com 24.496 ativos no geral. O protocolo A2A representa uma parcela significativa desse ecossistema.

Como um agente é submetido ou encontrado no índice Wellknown?

Agentes podem ser submetidos ao índice do Wellknown por auto-submissão ou descobertos automaticamente pelo índice:

• Auto-submissão: Publicadores podem enviar seus agentes provando controle do domínio ou repositório. Provas de controle incluem colocar um registro DNS TXT em _wellknown.SEU-DOMÍNIO, hospedar um arquivo de verificação em https://SEU-DOMÍNIO/.well-known/wellknown-verify.txt ou colocar um arquivo .wellknown-verify na raiz do repositório.

• Descoberta: O Wellknown descobre agentes escaneando fontes conhecidas como o registro MCP, npm, PyPI, GitHub e especificamente buscando Agent Cards em /.well-known/agent-card.json (fonte rotulada como a2a_card).

Uma vez indexado, o agente pode ser pesquisado, resolvido e verificado quanto ao status por meio dos endpoints HTTP da API do Wellknown e ferramentas do servidor MCP.

Resumo

O protocolo A2A permite que agentes de IA se encontrem e comuniquem publicando um Agent Card em um local padronizado. O Wellknown lê esses Agent Cards para indexar agentes, atualmente com 2.749 registros A2A e 2.153 ativos. Agentes entram no índice via auto-submissão ou descoberta, com verificação de controle de domínio garantindo autenticidade. Isso torna o Wellknown um recurso valioso para desenvolvedores que buscam agentes A2A ativos e suas capacidades.

Esses dados são um snapshot em 2026-10-31.