拡張メタデータ スキーマ

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