拡張メタデータ スキーマ

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/string スキルの機能を説明するキーワードのセット。
skills.examples array/string このスキルで処理できるプロンプトやシナリオの例。

apphub.googleapis.com/McpServer

apphub.googleapis.com/McpServer スキーマは、Model Context Protocol(MCP)サーバーのプロパティと、サーバーが公開するツールを定義します。App Hub は、機能タイププロパティが MCP_SERVER のサービスにこのスキーマを適用します。スキーマには、MCP 仕様に準拠するトランスポート エンドポイント宣言とツール定義が含まれています。これには、annotations の動作ヒントと _meta のポリシーヒントが含まれます。

スキーマ定義

このメタデータ タイプのスキーマを JSON 形式で以下に示します。

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "apphub.googleapis.com/McpServer",
  "description": "The schema for apphub.googleapis.com/McpServer.",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "displayName": {
      "type": "string",
      "description": "The display name of the MCP Server."
    },
    "description": {
      "type": "string",
      "description": "The description of the MCP Server."
    },
    "interfaces": {
      "type": "array",
      "description": "The connection details for the MCP Server.",
      "items": {
        "$ref": "#/definitions/Interface"
      }
    },
    "tools": {
      "type": "array",
      "description": "Tools provided by the MCP Server.",
      "items": {
        "$ref": "#/definitions/Tool"
      }
    }
  },
  "required": ["interfaces"],
  "definitions": {
    "Tool": {
      "description": "Represents a single tool provided by an MCP Server.",
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "name": {
          "type": "string",
          "description": "Human-readable name of the tool."
        },
        "description": {
          "type": "string",
          "description": "Description of what the tool does."
        },
        "annotations": {
          "$ref": "#/definitions/Tool.Annotations",
          "description": "Annotations associated with the tool."
        },
        "_meta": {
          "$ref": "#/definitions/Tool.Meta",
          "description": "Protocol-level metadata conforming to MCP _meta."
        }
      }
    },
    "Tool.Annotations": {
      "description": "Annotations describing the characteristics and behavior of a tool or operation.",
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "title": {
          "type": "string",
          "description": "A human-readable title or name for the tool or operation."
        },
        "destructiveHint": {
          "type": "boolean",
          "description": "Hint indicating if the operation can cause destructive changes."
        },
        "idempotentHint": {
          "type": "boolean",
          "description": "Hint indicating if the operation is idempotent (safe to retry)."
        },
        "openWorldHint": {
          "type": "boolean",
          "description": "Hint indicating if the operation assumes an open world."
        },
        "readOnlyHint": {
          "type": "boolean",
          "description": "Hint indicating if the operation is read-only."
        }
      }
    },
    "Tool.Meta": {
      "type": "object",
      "description": "Protocol-level tool metadata container conforming to MCP _meta.",
      "additionalProperties": false,
      "properties": {
        "com.googleapis.iap/PolicyHints": {
          "$ref": "#/definitions/Iap.PolicyHints",
          "description": "IAP specific policy hints."
        }
      }
    },
    "Iap.PolicyHints": {
      "type": "object",
      "description": "IAP custom extensions to MCP policy hints.",
      "additionalProperties": false,
      "properties": {
        "authorization": {
          "$ref": "#/definitions/Iap.Authorization",
          "description": "Authorization configurations for the tool."
        }
      }
    },
    "Iap.Authorization": {
      "type": "object",
      "description": "Authorization configuration including Human-in-the-loop (HITL) settings.",
      "additionalProperties": false,
      "properties": {
        "toolDisabled": {
          "type": "boolean",
          "description": "Indicates if the tool is disabled. Defaults to false when absent, which means the tool is enabled."
        },
        "hitlMode": {
          "type": "string",
          "description": "Human-in-the-loop (HITL) execution mode.",
          "enum": [
            "HITL_MODE_UNSPECIFIED",
            "HITL_MODE_DISABLED",
            "HITL_MODE_ALWAYS",
            "HITL_MODE_IF_UNSAFE"
          ]
        }
      }
    },
    "Interface": {
      "description": "Represents interface.",
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "url": {
          "type": "string",
          "description": "The destination URL.",
          "pattern": "^https?://"
        },
        "protocolBinding": {
          "type": "string",
          "description": "The protocol binding of the interface.",
          "enum": [
            "JSONRPC"
          ]
        }
      },
      "required": ["url", "protocolBinding"]
    }
  }
}

フィールドの説明

フィールド タイプ 説明
displayName string MCP サーバーの表示名。
description string MCP サーバーの説明。
interfaces array MCP サーバーの接続の詳細。
interfaces.url string インターフェースの宛先エンドポイント URL。
interfaces.protocolBinding string インターフェースのプロトコル バインディング(例: JSONRPC)。
tools array MCP サーバーが提供するツール。
tools.name string 人が読める形式のツール名。
tools.description string ツールの機能の説明。
tools.annotations object ツールに関連付けられた標準の MCP アノテーション。
tools.annotations.title string 人が読める形式のツールのタイトル。
tools.annotations.readOnlyHint boolean ツールがデータを取得するだけで、環境を変更しないかどうかを示すヒント。
tools.annotations.destructiveHint boolean オペレーションが破壊的な変更を引き起こす可能性があるかどうかを示すヒント。
tools.annotations.idempotentHint boolean オペレーションがべき等であり、安全に再試行できるかどうかを示すヒント。
tools.annotations.openWorldHint boolean オペレーションが外部システムとやり取りするかどうかを示すヒント。
tools._meta object MCP _meta 仕様に準拠したプロトコル レベルのメタデータ。キーはリバースドメイン表記にする必要があります。
tools._meta.com.googleapis.iap/PolicyHints object ツールの Identity-Aware Proxy(IAP)ポリシーのヒント。
tools._meta.com.googleapis.iap/PolicyHints.authorization object ツールの認可と人間参加型(HITL)の構成。
tools._meta.com.googleapis.iap/PolicyHints.authorization.toolDisabled boolean ツールが呼び出しで無効になっているかどうかを示します。ツールを無効にするには、true に設定します。省略した場合のデフォルトは false です。これは、ツールが有効になっていることを意味します。
tools._meta.com.googleapis.iap/PolicyHints.authorization.hitlMode string 人間参加型(HITL)実行モード。サポートされている値は HITL_MODE_UNSPECIFIED、HITL_MODE_DISABLED、HITL_MODE_ALWAYS、HITL_MODE_IF_UNSAFE です。

discoveryengine.googleapis.com/agentregistry/connector

discoveryengine.googleapis.com/agentregistry/connector スキーマは、Gemini Enterprise データコネクタのプロバイダ メタデータを定義します。Gemini Enterprise コネクタを介して外部の Model Context Protocol(MCP)サーバーを登録すると、App Hub はこの拡張メタデータを基盤となるサービス リソースにアタッチします。

Agent Registry は、対応する McpServer 検出リソースの attributes マップにこのメタデータを表示します。これにより、クライアント アプリケーションとオーケストレーター エージェントは、type、state、instanceUri などのコネクタ プロパティを検査できます。

スキーマ定義

このメタデータ タイプのスキーマを JSON 形式で以下に示します。

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "discoveryengine.googleapis.com/agentregistry/connector",
  "description": "Gemini Enterprise (Discovery Engine) connector metadata. Present on the McpServer of a resource backed by a Gemini Enterprise connector. Every field is optional.",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "type": {
      "type": "string",
      "description": "The type of the Gemini Enterprise connector, as a lowercase hyphen-separated identifier: for example 'github', 'atlassian-rovo'. Instances of the same connector share a type; it identifies which external service the connector integrates with.",
      "maxLength": 128
    },
    "version": {
      "type": "string",
      "description": "The version of the connector definition this instance was created from, for example '1.0'.",
      "maxLength": 32
    },
    "state": {
      "type": "string",
      "description": "The provisioning state of the connector instance. Some possible values are: 'STATE_UNSPECIFIED', 'INITIALIZING', 'INITIALIZED', 'INITIALIZATION_FAILED', 'ACTIVE', 'RUNNING', 'FAILED', 'WARNING', 'UPDATING' or 'DELETING'.",
      "maxLength": 64
    },
    "instanceUri": {
      "type": "string",
      "description": "The customer's own site, for connectors addressed per customer: for example 'https://acme.atlassian.net'. This is the tenant the connector reads from, and differs from the MCP endpoint in 'interfaces', which is the same for every customer of a given connector. Absent for connectors that address a single fixed endpoint.",
      "maxLength": 512
    },
    "tenantId": {
      "type": "string",
      "description": "The identifier of the customer tenant within the external service, where the service requires one to address it.",
      "maxLength": 128
    },
    "skills": {
      "type": "array",
      "description": "The Agent Registry skill revisions a Gemini Enterprise administrator added to this custom MCP connector, one entry per skill, at most five. Absent for other connectors and for custom MCP connectors without any.",
      "maxItems": 5,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "skill": {
            "type": "string",
            "description": "The resource name of the skill, in the form 'projects/{project_number}/locations/{location}/skills/{skill}'.",
            "minLength": 1,
            "maxLength": 1024
          },
          "skillUid": {
            "type": "string",
            "description": "The 'uid' of the skill.",
            "minLength": 1,
            "maxLength": 128
          },
          "revision": {
            "type": "string",
            "description": "The resource name of the skill revision, in the form 'projects/{project_number}/locations/{location}/skills/{skill}/revisions/{revision}'.",
            "minLength": 1,
            "maxLength": 1024
          },
          "revisionUid": {
            "type": "string",
            "description": "The 'uid' of the skill revision.",
            "minLength": 1,
            "maxLength": 128
          },
          "sha256": {
            "type": "string",
            "description": "The SHA-256 digest of the skill revision's payload, as 64 lowercase hexadecimal characters.",
            "pattern": "^[0-9a-f]{64}$"
          }
        },
        "required": ["skill", "skillUid", "revision", "revisionUid", "sha256"]
      }
    }
  }
}

フィールドの説明

フィールド タイプ 説明
type string Gemini Enterprise コネクタのタイプ。小文字のハイフン区切りの識別子として指定します。
version string このインスタンスの作成元となったコネクタ定義のバージョン。
state string コネクタ インスタンスのプロビジョニング状態。
instanceUri string テナントごとにアドレス指定されたコネクタのお客様サイトの URL。
tenantId string 外部サービス内のお客様テナントの識別子。
skills array カスタム MCP コネクタに接続されている Agent Registry スキル リビジョン(最大 5 つのエントリ)。他のコネクタと、スキルが関連付けられていないカスタム MCP コネクタの場合は省略されます。
skills.skill string スキルのリソース名(projects/PROJECT_NUMBER/locations/LOCATION/skills/SKILL 形式)。
skills.skillUid string スキルの固有識別子(uid)。
skills.revision string スキル リビジョンのリソース名(projects/PROJECT_NUMBER/locations/LOCATION/skills/SKILL/revisions/REVISION 形式)。
skills.revisionUid string スキル リビジョンの固有識別子(uid)。
skills.sha256 string スキル リビジョン ペイロードの SHA-256 ダイジェスト(64 文字の小文字の 16 進数)。