AgentCard

AgentCard conveys key information about a remote agent. It is a trimmed version of the AgentCard defined in the A2A protocol https://a2a-protocol.org/dev/specification/#441-agentcard

JSON representation
{
  "name": string,
  "description": string,
  "supportedInterfaces": [
    {
      object (AgentInterface)
    }
  ],
  "version": string,
  "skills": [
    {
      object (AgentSkill)
    }
  ]
}
Fields
name

string

Required. A human-readable name for the agent.

description

string

Required. A description of the agent's domain of action/solution space.

supportedInterfaces[]

object (AgentInterface)

Required. Ordered list of supported interfaces. The first entry is preferred.

version

string

Required. The version of the agent.

skills[]

object (AgentSkill)

Required. Skills represent a unit of ability an agent can perform. This may somewhat abstract but represents a more focused set of actions that the agent is highly likely to succeed at.

AgentInterface

Declares a combination of a target URL, transport and protocol version for interacting with the agent. This allows agents to expose the same functionality over multiple protocol binding mechanisms.

JSON representation
{
  "url": string,
  "protocolBinding": string,
  "tenant": string,
  "protocolVersion": string
}
Fields
url

string

Required. The URL where this interface is available. Must be a valid absolute HTTPS URL in production. Example: "https://api.example.com/a2a/v1", "https://grpc.example.com/a2a"

protocolBinding

string

Required. The protocol binding supported at this URL. This is an open form string, to be easily extended for other protocol bindings. The core ones officially supported are JSONRPC, GRPC and HTTP+JSON.

tenant

string

Tenant ID to be used in the request when calling the agent.

protocolVersion

string

Required. The version of the A2A protocol this interface exposes. Use the latest supported minor version per major version. Examples: "0.3", "1.0"

AgentSkill

Represents a distinct capability or function that an agent can perform.

JSON representation
{
  "id": string,
  "name": string,
  "description": string,
  "tags": [
    string
  ],
  "examples": [
    string
  ],
  "inputModes": [
    string
  ],
  "outputModes": [
    string
  ]
}
Fields
id

string

Required. A unique identifier for the agent's skill.

name

string

Required. A human-readable name for the skill.

description

string

Required. A detailed description of the skill.

tags[]

string

Required. A set of keywords describing the skill's capabilities.

examples[]

string

Example prompts or scenarios that this skill can handle.

inputModes[]

string

The set of supported input media types for this skill, overriding the agent's defaults.

outputModes[]

string

The set of supported output media types for this skill, overriding the agent's defaults.