> [!WARNING]
>
> **Preview**
>
>
> This product or feature is
>
> subject to the "Pre-GA Offerings Terms" in the General Service Terms section
> of the [Service Specific
> Terms](https://docs.cloud.google.com/terms/service-terms#1).
>
> Pre-GA products and features are available "as is" and might have limited support.
>
> For more information, see the
> [launch stage descriptions](https://cloud.google.com/products/#product-launch-stages).

App Hub automatically adds [extended metadata](https://docs.cloud.google.com/app-hub/docs/overview.md.txt#properties-and-attributes)
to some services and workloads to improve discoverability, governance, and
integration with other systems. A unique key identifies each supported schema
and defines the structure and fields for a specific type of metadata. To view
this metadata, see [View extended metadata schemas](https://docs.cloud.google.com/app-hub/docs/modify-app-hub-resources.md.txt#view-schemas).

## `apphub.googleapis.com/AgentProperties`

This schema is used to describe the properties of an AI agent, letting other
systems find and understand it. It is typically applied to workloads that have a
functional type [property](https://docs.cloud.google.com/app-hub/docs/overview.md.txt#properties-and-attributes) of
`AGENT`. The schema is compatible with the
[Agent2Agent (A2A) Agent Card](https://a2a-protocol.org/latest/specification/#5-agent-discovery-the-agent-card).

### Schema definition

The following is the schema for this metadata type in JSON format.

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "apphub.googleapis.com/AgentProperties",
  "description": "The schema for apphub.googleapis.com/AgentProperties. Except for framework, the properties are derived from the A2A Agent Card.",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "displayName": {
      "type": "string",
      "description": "The display name of the agent."
    },
    "description": {
      "type": "string",
      "description": "The description of the agent."
    },
    "version": {
      "type": "string",
      "description": "Contains the version of the Agent."
    },
    "framework": {
      "type": "string",
      "description": "The agent framework used to develop the agent."
    },
    "agentCardUri": {
      "type": "string",
      "description": "The URI of the agent card for the agent."
    },
    "skills": {
      "type": "array",
      "description": "A list of skills the agent possesses.",
      "items": {
        "type": "object",
        "title": "Skills",
        "description": "Defines a skill for an agent.",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "description": "A unique identifier for the agent's skill."
          },
          "name": {
            "type": "string",
            "description": "A human readable name for the agent's skill."
          },
          "description": {
            "type": "string",
            "description": "A description of the agent's skill."
          },
          "tags": {
            "type": "array",
            "description": "A set of keywords describing the skill's capabilities.",
            "items": {
              "type": "string"
            }
          },
          "examples": {
            "type": "array",
            "description": "Example prompts or scenarios that this skill can handle.",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

### Field descriptions

| Field | Type | Description |
|---|---|---|
| `displayName` | `string` | The display name of the agent. |
| `description` | `string` | The description of the agent. |
| `version` | `string` | The version of the agent. |
| `framework` | `string` | The framework used to develop the agent. |
| `agentCardUri` | `string` | The URI of the agent card for the agent. |
| `skills` | `array` | A list of skills the agent possesses. |
| `skills.id` | `string` | A unique identifier for the agent's skill. |
| `skills.name` | `string` | A human readable name for the agent's skill. |
| `skills.description` | `string` | A description of the agent's skill. |
| `skills.tags` | `array` of `string` | A set of keywords describing the skill's capabilities. |
| `skills.examples` | `array` of `string` | Example prompts or scenarios that this skill can handle. |