Erweiterte Metadatenschemas

App Hub fügt einigen Diensten und Arbeitslasten automatisch erweiterte Metadaten hinzu, um die Auffindbarkeit, Governance und Integration in andere Systeme zu verbessern. Ein eindeutiger Schlüssel identifiziert jedes unterstützte Schema und definiert die Struktur und die Felder für einen bestimmten Metadatentyp. Informationen zum Aufrufen dieser Metadaten finden Sie unter Erweiterte Metadatenschemas ansehen.

apphub.googleapis.com/AgentProperties

Dieses Schema wird verwendet, um die Eigenschaften eines KI-Agenten zu beschreiben, damit andere Systeme ihn finden und verstehen können. Sie wird in der Regel auf Arbeitslasten angewendet, die das funktionale Attribut AGENT haben. Das Schema ist mit der Agent2Agent-Agentenkarte (A2A) kompatibel.

Schemadefinition

Im Folgenden finden Sie das Schema für diesen Metadatentyp im JSON-Format.

{
  "$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"
            }
          }
        }
      }
    }
  }
}

Feldbeschreibungen

Feld Typ Beschreibung
displayName string Der Anzeigename des KI-Agenten.
description string Die Beschreibung des Agents.
version string Die Version des KI-Agenten.
framework string Das Framework, das zur Entwicklung des KI-Agenten verwendet wurde.
agentCardUri string Der URI der KI-Agentenkarte für den KI-Agenten.
skills array Eine Liste der Skills, die der Agent besitzt.
skills.id string Eine eindeutige Kennung für die Fähigkeit des KI-Agenten.
skills.name string Ein menschenlesbarer Name für den Skill des KI-Agenten.
skills.description string Eine Beschreibung des Skills des KI-Agenten.
skills.tags array von string Eine Reihe von Keywords, die die Funktionen des Skills beschreiben.
skills.examples array von string Beispiel-Prompts oder ‑Szenarien, die dieser Skill verarbeiten kann.

apphub.googleapis.com/McpServer

Das Schema apphub.googleapis.com/McpServer definiert die Attribute eines MCP-Servers (Model Context Protocol) und die von ihm bereitgestellten Tools. App Hub wendet dieses Schema auf Dienste an, die das funktionale Attribut MCP_SERVER haben. Das Schema enthält Deklarationen für Transportendpunkte und Tooldefinitionen, die der MCP-Spezifikation entsprechen, einschließlich Verhaltenshinweisen in annotations und Richtlinienhinweisen in _meta.

Schemadefinition

Im Folgenden finden Sie das Schema für diesen Metadatentyp im JSON-Format.

{
  "$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"]
    }
  }
}

Feldbeschreibungen

Feld Typ Beschreibung
displayName string Der Anzeigename des MCP-Servers.
description string Die Beschreibung des MCP-Servers.
interfaces array Die Verbindungsdetails für den MCP-Server.
interfaces.url string Die Zielendpunkt-URL für die Schnittstelle.
interfaces.protocolBinding string Die Protokollbindung der Schnittstelle, z. B. JSONRPC.
tools array Vom MCP-Server bereitgestellte Tools.
tools.name string Menschenlesbarer Name des Tools.
tools.description string Beschreibung der Funktion des Tools.
tools.annotations object Standard-MCP-Anmerkungen, die mit dem Tool verknüpft sind.
tools.annotations.title string Ein menschenlesbarer Titel für das Tool.
tools.annotations.readOnlyHint boolean Hinweis, der angibt, ob das Tool nur Daten abruft und seine Umgebung nicht ändert.
tools.annotations.destructiveHint boolean Hinweis, ob der Vorgang destruktive Änderungen verursachen kann.
tools.annotations.idempotentHint boolean Hinweis, der angibt, ob der Vorgang idempotent ist und sicher wiederholt werden kann.
tools.annotations.openWorldHint boolean Hinweis, ob der Vorgang mit externen Systemen interagiert.
tools._meta object Metadaten auf Protokollebene, die der MCP-_meta-Spezifikation entsprechen. Schlüssel müssen der Reverse-Domain-Notation entsprechen.
tools._meta.com.googleapis.iap/PolicyHints object IAP-Richtlinienhinweise (Identity-Aware Proxy) für das Tool.
tools._meta.com.googleapis.iap/PolicyHints.authorization object Autorisierungs- und Human-in-the-Loop-Konfiguration (HITL) für das Tool.
tools._meta.com.googleapis.iap/PolicyHints.authorization.toolDisabled boolean Gibt an, ob das Tool für den Aufruf deaktiviert ist. Legen Sie true fest, um das Tool zu deaktivieren. Wenn keine Angabe gemacht wird, ist der Standardwert false. Das bedeutet, dass das Tool aktiviert ist.
tools._meta.com.googleapis.iap/PolicyHints.authorization.hitlMode string Human-in-the-Loop-Ausführungsmodus (HITL). Unterstützte Werte sind HITL_MODE_UNSPECIFIED, HITL_MODE_DISABLED, HITL_MODE_ALWAYS und HITL_MODE_IF_UNSAFE.

discoveryengine.googleapis.com/agentregistry/connector

Das discoveryengine.googleapis.com/agentregistry/connector-Schema definiert Anbieter-Metadaten für Gemini Enterprise-Daten-Connectors. Wenn Sie einen externen MCP-Server (Model Context Protocol) über einen Gemini Enterprise-Connector registrieren, hängt App Hub diese erweiterten Metadaten an die zugrunde liegende Dienstressource an.

Die Agent Registry stellt diese Metadaten in der attributes-Zuordnung der entsprechenden McpServer-Erkennungsressource bereit, damit Clientanwendungen und Orchestrator-Agenten Connector-Eigenschaften wie type, state und instanceUri prüfen können.

Schemadefinition

Im Folgenden finden Sie das Schema für diesen Metadatentyp im JSON-Format.

{
  "$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"]
      }
    }
  }
}

Feldbeschreibungen

Feld Typ Beschreibung
type string Der Typ des Gemini Enterprise-Connectors als kleingeschriebene, durch Bindestriche getrennte Kennung.
version string Die Version der Connector-Definition, aus der diese Instanz erstellt wurde.
state string Der Bereitstellungsstatus der Connector-Instanz.
instanceUri string Die URL der Kundenwebsite für Connectors, die pro Mandant adressiert werden.
tenantId string Die Kennung des Kundenmandanten innerhalb des externen Dienstes.
skills array Die Skill-Versionen der Agent Registry, die an einen benutzerdefinierten MCP-Connector angehängt sind, bis zu fünf Einträge. Wird für andere Connectors und für benutzerdefinierte MCP-Connectors ohne angehängte Skills weggelassen.
skills.skill string Der Ressourcenname der Fähigkeit im Format projects/PROJECT_NUMBER/locations/LOCATION/skills/SKILL.
skills.skillUid string Die eindeutige Kennung (uid) des Skills.
skills.revision string Der Ressourcenname der Skill-Version im Format projects/PROJECT_NUMBER/locations/LOCATION/skills/SKILL/revisions/REVISION.
skills.revisionUid string Die eindeutige Kennung (uid) der Skill-Version.
skills.sha256 string Der SHA-256-Digest der Nutzlast der Skill-Version als 64 Hexadezimalzeichen in Kleinbuchstaben.