扩展的元数据架构

本页面提供了一个目录，其中列出了服务和工作负载上扩展元数据 property 支持的架构。扩展元数据可为 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 此技能可处理的提示或场景示例。