확장된 메타데이터 스키마

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 이 기술이 처리할 수 있는 프롬프트 또는 시나리오의 예입니다.