Agent card
Concept
No protocolo A2A, um cartão de agente é um documento legível por máquina, publicado num URL bem conhecido, que descreve o nome do agente, as suas capacidades, competências, endpoint, requisitos de autenticação e formatos de entrada e saída, para que outros agentes o possam descobrir.
Também abordados
Os episódios sobre Agent card abordam também Microsoft Purview Information Barriers, Context window, Front matter, Agent kill switch, AI red teaming e AI Center of Excellence.
Descrição
Um agent card é um documento legível por máquina, usado no protocolo Agent2Agent (A2A) para descrever um agente. Ele é publicado em uma URL well-known e traz metadados como o nome do agente, sua descrição, versão, capacidades, skills, endpoint, requisitos de autenticação e os formatos de entrada e saída que ele suporta. Seu propósito central é a descoberta: um cliente ou outro agente pode ler o card para saber o que um agente oferece antes de enviar qualquer requisição a ele.
O protocolo A2A trata da interoperabilidade entre agentes com ênfase em uma linguagem padronizada, o que elimina a necessidade de código personalizado em cada interação entre agentes. O agent card é a parte dessa abordagem que permite a um agente anunciar sua identidade e suas capacidades. Em vez de presumir de antemão como funciona um agente remoto, um agente chamador lê o card publicado, descobre como chegar até o agente e quais tipos de dados ele pode trocar.
A página do Microsoft Learn sobre hospedagem de A2A no Microsoft Agent Framework mostra como isso funciona na prática. No exemplo de hospedagem com ASP.NET Core, o card é servido em um caminho well-known que termina em agent-card.json. O método de mapeamento que expõe o card vem do pacote do A2A SDK, e não dos pacotes de hospedagem do Agent Framework. O exemplo de card define um nome, uma descrição e uma versão, os modos padrão de entrada e saída, e uma interface suportada que inclui uma URL, um protocol binding e uma versão do protocolo. A página recomenda que o card seja totalmente preenchido em ambientes de produção, para que os clientes recebam informações completas sobre o agente que estão prestes a chamar.
Uma limitação prática descrita na documentação diz respeito à hospedagem. Um único host pode publicar apenas um agent card no caminho well-known, o que significa que apenas um agente fica descobrível ali. Outros agentes hospedados junto com ele continuam acessíveis por meio de suas próprias URLs, mas os clientes precisam já conhecer esses endpoints, pois a localização well-known compartilhada não os lista. Ao planejar uma implantação com vários agentes, isso afeta como a descoberta é desenhada e como as informações de endpoint são compartilhadas com os consumidores. A página da documentação não aborda skills, detalhes de autenticação ou assinaturas do card, por isso esses aspectos são descritos aqui apenas no nível da definição geral.
O episódio "Agent-to-Agent (A2A) Communication - Simply Explained" aborda o conceito como parte de uma discussão mais ampla sobre interoperabilidade. Ele apresenta o agent card como o mecanismo pelo qual os agentes anunciam sua identidade e capacidades, facilitando a descoberta e a interação. O mesmo episódio conecta isso à comunicação estruturada, em que agentes trocam diversos tipos de dados, o que apoia a colaboração e o acompanhamento do estado das tarefas. Ele também destaca que privacidade e segurança são preocupações centrais na comunicação entre agentes, e que quem trabalha com esses sistemas deve estar atento aos riscos associados ao tratamento de dados. Como um agent card publica informações sobre um agente e sobre como chegar até ele, decidir o que incluir e como o acesso é controlado faz parte dessa consideração de segurança mais ampla.
Em resumo, o agent card funciona como a descrição pública de um agente A2A. Ele é lido pelos clientes antes do envio de qualquer tarefa, é servido em uma localização previsível e deve ser completo e preciso em produção. A restrição de um card por caminho well-known, no exemplo de hospedagem com ASP.NET Core, é um ponto de design a considerar sempre que mais de um agente for exposto pelo mesmo host.
Overview compiled with AI from M365.FM episodes and the facts on this page. You can improve it with the edit button below.
| Tipo | Concept |
|---|---|
| Kind | Format |
Perguntas frequentes
Questions marked with AI were written with AI from the facts on this page.
O que é um agent card no protocolo A2A? (AI)
É um documento legível por máquina, publicado em uma URL well-known, que descreve o nome do agente, suas capacidades, skills, endpoint, requisitos de autenticação e formatos de entrada e saída, para que outros agentes possam descobri-lo.
Onde o agent card é servido no exemplo do Microsoft Agent Framework? (AI)
No exemplo de hospedagem com ASP.NET Core, ele é servido em um caminho well-known que termina em agent-card.json, usando um método de mapeamento do pacote do A2A SDK, e não dos pacotes de hospedagem do Agent Framework.
Um mesmo host pode publicar vários agent cards? (AI)
Segundo a página do Microsoft Learn, um único host pode publicar apenas um agent card no caminho well-known, então só um agente fica descobrível ali; os outros continuam acessíveis pelas próprias URLs, que os clientes precisam já conhecer.
Community wiki
Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.
Especialistas e empresas para este tópico
Ninguém indicou ainda este tópico. Adicione-o ao seu perfil.
Maintained by Mirko Peters (Microsoft MVP) · Last updated: