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 進数)。 |