擴充中繼資料結構定義

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 代理技能的專屬 ID。
skills.name string 人類可讀的代理技能名稱。
skills.description string 代理技能的說明。
skills.tags array/string 一組描述技能功能的關鍵字。
skills.examples array/string 這項技能可處理的提示或情境範例。