확장된 메타데이터 스키마

이 페이지에서는 서비스 및 워크로드의 확장 메타데이터 속성에 지원되는 스키마 카탈로그를 제공합니다. 확장된 메타데이터는 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 이 스킬이 처리할 수 있는 프롬프트 또는 시나리오의 예시입니다.