AgentCard

O AgentCard transmite informações importantes sobre um agente remoto. É uma versão reduzida do AgentCard definido no protocolo A2A https://a2a-protocol.org/dev/specification/#441-agentcard

Representação JSON 
{
  "name": string,
  "description": string,
  "supportedInterfaces": [
    {
      object (AgentInterface)
    }
  ],
  "version": string,
  "skills": [
    {
      object (AgentSkill)
    }
  ]
}
Campos
name

string

Obrigatório. Um nome do agente legível por humanos.
description

string

Obrigatório. Uma descrição do domínio de ação/espaço de solução do agente.
supportedInterfaces[]

object (AgentInterface)

Obrigatório. Lista ordenada de interfaces compatíveis. A primeira entrada é a preferida.
version

string

Obrigatório. A versão do agente.
skills[]

object (AgentSkill)

Obrigatório. As habilidades representam uma unidade de capacidade que um agente pode realizar. Isso pode ser um pouco abstrato, mas representa um conjunto mais focado de ações que o agente tem grande probabilidade de realizar com sucesso.

AgentInterface

Declara uma combinação de um URL de destino, transporte e versão do protocolo para interagir com o agente. Isso permite que os agentes exponham a mesma funcionalidade em vários mecanismos de vinculação de protocolo.

Representação JSON 
{
  "url": string,
  "protocolBinding": string,
  "tenant": string,
  "protocolVersion": string
}
Campos
url

string

Obrigatório. O URL em que essa interface está disponível. Precisa ser um URL HTTPS absoluto válido em produção. Exemplo: "https://api.example.com/a2a/v1", "https://grpc.example.com/a2a"
protocolBinding

string

Obrigatório. A vinculação de protocolo compatível com este URL. Essa é uma string de formulário aberta, que pode ser facilmente estendida para outras vinculações de protocolo. Os principais com suporte oficial são JSONRPC, GRPC e HTTP+JSON.
tenant

string

ID do locatário a ser usado na solicitação ao chamar o agente.
protocolVersion

string

Obrigatório. A versão do protocolo A2A que essa interface expõe. Use a versão secundária mais recente compatível por versão principal. Exemplos: "0.3", "1.0"

AgentSkill

Representa uma capacidade ou função distinta que um agente pode realizar.

Representação JSON 
{
  "id": string,
  "name": string,
  "description": string,
  "tags": [
    string
  ],
  "examples": [
    string
  ],
  "inputModes": [
    string
  ],
  "outputModes": [
    string
  ]
}
Campos
id

string

Obrigatório. Um identificador exclusivo da habilidade do agente.
name

string

Obrigatório. Um nome legível para a habilidade.
description

string

Obrigatório. Uma descrição detalhada da habilidade.
tags[]

string

Obrigatório. Um conjunto de palavras-chave que descrevem as funcionalidades da skill.
examples[]

string

Exemplos de comandos ou cenários que essa habilidade pode processar.
inputModes[]

string

O conjunto de tipos de mídia de entrada compatíveis com essa habilidade, substituindo os padrões do agente.
outputModes[]

string

O conjunto de tipos de mídia de saída compatíveis com essa habilidade, substituindo os padrões do agente.