拡張メタデータ スキーマ

このページでは、サービスとワークロードの拡張メタデータ プロパティでサポートされているスキーマのカタログを提供します。拡張メタデータは、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 このスキルで処理できるプロンプトやシナリオの例。