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 스키마는 모델 컨텍스트 프로토콜(MCP) 서버의 속성과 서버가 노출하는 도구를 정의합니다. App Hub는 이 스키마를 기능 유형 속성이 MCP_SERVER인 서비스에 적용합니다.
스키마에는 annotations의 동작 힌트와 _meta의 정책 힌트를 포함하여 MCP 사양을 준수하는 전송 엔드포인트 선언과 도구 정의가 포함됩니다.
스키마 정의
다음은 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 |
도구의 IAP(Identity-Aware Proxy) 정책 힌트입니다. |
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 커넥터를 통해 외부 모델 컨텍스트 프로토콜(MCP) 서버를 등록하면 App Hub는 이 확장된 메타데이터를 기본 서비스 리소스에 연결합니다.
에이전트 레지스트리는 클라이언트 애플리케이션과 조정자 에이전트가 type, state, instanceUri와 같은 커넥터 속성을 검사할 수 있도록 해당 McpServer 탐색 리소스의 attributes 맵에 이 메타데이터를 표시합니다.
스키마 정의
다음은 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 |
SKILL의 리소스 이름입니다(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 |
64개의 소문자 16진수 문자로 된 스킬 버전 페이로드의 SHA-256 다이제스트입니다. |