扩展的元数据架构

本页面提供了一个目录，其中列出了服务和工作负载的扩展元数据 属性支持的架构。扩展元数据为 App Hub 应用组件添加了丰富的结构化数据，为治理、运营以及与其他系统的集成提供了上下文。

每个架构都由一个唯一的键标识，并定义了特定类型元数据的结构和字段。

如需了解如何直观呈现此元数据，请参阅 查看扩展元数据架构。

apphub.googleapis.com/AgentProperties

此架构用于描述 AI 智能体的属性，以便其他系统能够找到并了解该智能体。它通常应用于功能类型属性为 AGENT的工作负载。该架构与 Agent2Agent (A2A) 智能体卡片兼容。

架构定义

以下是 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"
            }
          }
        }
      }
    }
  }
}

字段说明

字段 类型 说明
displayName string 智能体的显示名称。
description string 智能体的说明。
version string 智能体的版本。
framework string 用于开发智能体的框架。
agentCardUri string 智能体的智能体卡片的 URI。
skills array 智能体拥有的技能列表。
skills.id string 智能体技能的唯一标识符。
skills.name string 智能体技能的人类可读名称。
skills.description string 智能体技能的说明。
skills.tags array 的 string 一组用于描述技能功能的关键字。
skills.examples array 的 string 此技能可以处理的示例提示或场景。