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 ( |
| Fields | |
|---|---|
name |
Required. A human-readable name for the agent. |
description |
Required. A description of the agent's domain of action/solution space. |
supportedInterfaces[] |
Required. Ordered list of supported interfaces. The first entry is preferred. |
version |
Required. The version of the agent. |
skills[] |
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 |
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 |
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 |
tenant |
Tenant ID to be used in the request when calling the agent. |
protocolVersion |
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 |
Required. A unique identifier for the agent's skill. |
name |
Required. A human-readable name for the skill. |
description |
Required. A detailed description of the skill. |
tags[] |
Required. A set of keywords describing the skill's capabilities. |
examples[] |
Example prompts or scenarios that this skill can handle. |
inputModes[] |
The set of supported input media types for this skill, overriding the agent's defaults. |
outputModes[] |
The set of supported output media types for this skill, overriding the agent's defaults. |