- [JSON representation](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/AgentCard#SCHEMA_REPRESENTATION)
- [AgentInterface](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/AgentCard#AgentInterface)
  - [JSON representation](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/AgentCard#AgentInterface.SCHEMA_REPRESENTATION)
- [AgentSkill](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/AgentCard#AgentSkill)
  - [JSON representation](https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/AgentCard#AgentSkill.SCHEMA_REPRESENTATION)

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 (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/AgentCard#AgentInterface`) } ], "version": string, "skills": [ { object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/AgentCard#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 (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/AgentCard#AgentInterface`)`` Required. Ordered list of supported interfaces. The first entry is preferred. |
| `version` | `string` Required. The version of the agent. |
| `skills[]` | ``object (`https://docs.cloud.google.com/gemini-enterprise-cx/cx-agent-studio/reference/rest/v1beta/AgentCard#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. |