확장된 메타데이터 스키마

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 다이제스트입니다.