App Hub ajoute automatiquement des métadonnées étendues à certains services et charges de travail pour améliorer la visibilité, la gouvernance et l'intégration avec d'autres systèmes. Une clé unique identifie chaque schéma compatible et définit la structure et les champs d'un type de métadonnées spécifique. Pour afficher ces métadonnées, consultez Afficher les schémas de métadonnées étendus.
apphub.googleapis.com/AgentProperties
Ce schéma permet de décrire les propriétés d'un agent IA, ce qui permet à d'autres systèmes de le trouver et de le comprendre. Il est généralement appliqué aux charges de travail dont la propriété de type fonctionnel est AGENT. Le schéma est compatible avec la carte d'agent Agent2Agent (A2A).
Définition du schéma
Voici le schéma de ce type de métadonnées au format 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"
}
}
}
}
}
}
}
Descriptions de champs
| Champ | Type | Description |
|---|---|---|
displayName |
string |
Nom à afficher de l'agent. |
description |
string |
Description de l'agent. |
version |
string |
Version de l'agent. |
framework |
string |
Framework utilisé pour développer l'agent. |
agentCardUri |
string |
URI de la fiche de l'agent. |
skills |
array |
Liste des compétences de l'agent. |
skills.id |
string |
Identifiant unique de la compétence de l'agent. |
skills.name |
string |
Nom lisible de la compétence de l'agent. |
skills.description |
string |
Description de la compétence de l'agent. |
skills.tags |
array sur string |
Ensemble de mots clés décrivant les capacités de la compétence. |
skills.examples |
array sur string |
Exemples de requêtes ou de scénarios que cette compétence peut gérer. |
apphub.googleapis.com/McpServer
Le schéma apphub.googleapis.com/McpServer définit les propriétés d'un serveur MCP (Model Context Protocol) et les outils qu'il expose. App Hub applique ce schéma aux services dont la propriété de type fonctionnel est MCP_SERVER.
Le schéma inclut des déclarations de points de terminaison de transport et des définitions d'outils conformes à la spécification MCP, y compris des indications de comportement dans annotations et des indications de règles dans _meta.
Définition du schéma
Voici le schéma de ce type de métadonnées au format 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"]
}
}
}
Descriptions de champs
| Champ | Type | Description |
|---|---|---|
displayName |
string |
Nom à afficher du serveur MCP. |
description |
string |
Description du serveur MCP. |
interfaces |
array |
Détails de connexion au serveur MCP. |
interfaces.url |
string |
URL du point de terminaison de destination de l'interface. |
interfaces.protocolBinding |
string |
Liaison de protocole de l'interface, par exemple JSONRPC. |
tools |
array |
Outils fournis par le serveur MCP. |
tools.name |
string |
Nom de l'outil lisible par l'humain. |
tools.description |
string |
Description de ce que fait l'outil. |
tools.annotations |
object |
Annotations MCP standards associées à l'outil. |
tools.annotations.title |
string |
Titre de l'outil lisible par l'humain. |
tools.annotations.readOnlyHint |
boolean |
Indication précisant si l'outil ne fait que récupérer des données et ne modifie pas son environnement. |
tools.annotations.destructiveHint |
boolean |
Indication précisant si l'opération peut entraîner des modifications destructrices. |
tools.annotations.idempotentHint |
boolean |
Indication précisant si l'opération est idempotente et peut être relancée en toute sécurité. |
tools.annotations.openWorldHint |
boolean |
Indication précisant si l'opération interagit avec des systèmes externes. |
tools._meta |
object |
Métadonnées au niveau du protocole conformes à la spécification MCP _meta. Les clés doivent respecter la notation de domaine inversé. |
tools._meta.com.googleapis.iap/PolicyHints |
object |
Conseils sur les règles Identity-Aware Proxy (IAP) pour l'outil. |
tools._meta.com.googleapis.iap/PolicyHints.authorization
|
object |
Configuration de l'autorisation et de l'intervention humaine (HITL) pour l'outil. |
tools._meta.com.googleapis.iap/PolicyHints.authorization.toolDisabled
|
boolean |
Indique si l'outil est désactivé pour l'appel. Définissez sur true pour désactiver l'outil. La valeur par défaut est false lorsqu'elle est omise, ce qui signifie que l'outil est activé. |
tools._meta.com.googleapis.iap/PolicyHints.authorization.hitlMode
|
string |
Mode d'exécution human-in-the-loop (avec intervention humaine, HITL). Les valeurs acceptées sont HITL_MODE_UNSPECIFIED, HITL_MODE_DISABLED, HITL_MODE_ALWAYS et HITL_MODE_IF_UNSAFE. |
discoveryengine.googleapis.com/agentregistry/connector
Le schéma discoveryengine.googleapis.com/agentregistry/connector définit les métadonnées du fournisseur pour les connecteurs de données Gemini Enterprise. Lorsque vous enregistrez un serveur MCP (Model Context Protocol) externe via un connecteur Gemini Enterprise, App Hub associe ces métadonnées étendues à la ressource de service sous-jacente.
Agent Registry affiche ces métadonnées dans le mappage attributes de la ressource de découverte McpServer correspondante afin que les applications clientes et les agents d'orchestration puissent inspecter les propriétés du connecteur telles que type, state et instanceUri.
Définition du schéma
Voici le schéma de ce type de métadonnées au format 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"]
}
}
}
}
Descriptions de champs
| Champ | Type | Description |
|---|---|---|
type |
string |
Type du connecteur Gemini Enterprise sous la forme d'un identifiant en minuscules séparé par des traits d'union. |
version |
string |
Version de la définition du connecteur à partir de laquelle cette instance a été créée. |
state |
string |
État de provisionnement de l'instance de connecteur. |
instanceUri |
string |
URL du site client pour les connecteurs adressés par locataire. |
tenantId |
string |
Identifiant du locataire client au sein du service externe. |
skills |
array |
Révisions de compétences Agent Registry associées à un connecteur MCP personnalisé, jusqu'à cinq entrées. Omis pour les autres connecteurs et pour les connecteurs MCP personnalisés sans compétences associées. |
skills.skill |
string |
Nom de ressource de la compétence, au format projects/PROJECT_NUMBER/locations/LOCATION/skills/SKILL. |
skills.skillUid |
string |
Identifiant unique (uid) de la compétence. |
skills.revision |
string |
Nom de ressource de la révision de la compétence, au format projects/PROJECT_NUMBER/locations/LOCATION/skills/SKILL/revisions/REVISION. |
skills.revisionUid |
string |
Identifiant unique (uid) de la révision de la compétence. |
skills.sha256 |
string |
Condensé SHA-256 de la charge utile de la révision de la compétence sous la forme de 64 caractères hexadécimaux en minuscules. |