擴充中繼資料結構定義

本頁提供服務和工作負載的擴充中繼資料 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 專員技能的專屬 ID。
skills.name string 使用者可解讀的代理程式技能名稱。
skills.description string 代理程式技能的說明。
skills.tags array/string 一組描述技能功能的關鍵字。
skills.examples array/string 這項技能可處理的提示或情境範例。