拡張メタデータ スキーマ

App Hub は、一部のサービスとワークロードに拡張メタデータを自動的に追加して、検出可能性、ガバナンス、他のシステムとの統合を改善します。一意のキーは、サポートされている各スキーマを識別し、特定のタイプのメタデータの構造とフィールドを定義します。このメタデータを表示するには、拡張メタデータ スキーマを表示するをご覧ください。

apphub.googleapis.com/AgentProperties

このスキーマは、AI エージェントのプロパティを記述するために使用され、他のシステムが 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 このスキルで処理できるプロンプトやシナリオの例。