扩展的元数据架构

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 此技能可以处理的示例提示或场景。