--- title: "Protocolo A2A Explicado: Agent Cards e Indexação no Wellknown" description: "Entenda o protocolo A2A, como funcionam os Agent Cards e como o Wellknown indexa e encontra agentes A2A." lang: pt published: 2026-10-31T00:32:32.305Z data_as_of: 2026-10-31T00:32:09.545Z canonical: https://wellknown.network/pt/blog/what-is-the-a2a-protocol facts: https://wellknown.network/pt/blog/what-is-the-a2a-protocol/facts.json alternates: en: https://wellknown.network/en/blog/what-is-the-a2a-protocol/article.md es: https://wellknown.network/es/blog/what-is-the-a2a-protocol/article.md pt: https://wellknown.network/pt/blog/what-is-the-a2a-protocol/article.md de: https://wellknown.network/de/blog/what-is-the-a2a-protocol/article.md fr: https://wellknown.network/fr/blog/what-is-the-a2a-protocol/article.md ja: https://wellknown.network/ja/blog/what-is-the-a2a-protocol/article.md ko: https://wellknown.network/ko/blog/what-is-the-a2a-protocol/article.md zh-Hans: https://wellknown.network/zh/blog/what-is-the-a2a-protocol/article.md hi: https://wellknown.network/hi/blog/what-is-the-a2a-protocol/article.md id: https://wellknown.network/id/blog/what-is-the-a2a-protocol/article.md tr: https://wellknown.network/tr/blog/what-is-the-a2a-protocol/article.md --- # Protocolo A2A Explicado: Agent Cards e Indexação no Wellknown Entenda o protocolo A2A, como funcionam os Agent Cards e como o Wellknown indexa e encontra agentes A2A. 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. ## Perguntas frequentes ### O que é o protocolo A2A? O protocolo A2A é um padrão aberto que permite que agentes de IA se descubram e troquem tarefas usando JSON-RPC. Os agentes publicam um Agent Card que descreve sua identidade e capacidades. ### Onde fica o Agent Card e o que ele descreve? O Agent Card é um documento JSON publicado em /.well-known/agent-card.json no domínio do agente. Ele descreve o nome do agente, habilidades, URL do endpoint e esquemas de segurança. ### Quantos agentes do protocolo A2A o Wellknown indexa e quantos estão ativos? O Wellknown indexa 2.749 registros do protocolo A2A, com 2.153 atualmente ativos, ou seja, cuja última verificação foi bem-sucedida nas últimas 24 horas. ### Como um agente é submetido ou encontrado no índice Wellknown? Agentes podem ser submetidos provando controle do domínio ou repositório por meio de provas de controle, ou descobertos automaticamente pelo Wellknown buscando seus Agent Cards e outras fontes. ### Qual a diferença entre dados declarados e observados no Wellknown? Dados declarados são metadados informados pelo publicador, enquanto dados observados são o que o Wellknown mede ao verificar o endpoint do agente, como status e latência.