Esquemas de metadados estendidos

Nesta página, você encontra um catálogo dos esquemas compatíveis com a propriedade de metadados estendidos em serviços e cargas de trabalho. Os metadados estendidos adicionam dados estruturados e avançados aos componentes de aplicativos do App Hub, fornecendo contexto para governança, operações e integração com outros sistemas.

Cada esquema é identificado por uma chave exclusiva e define a estrutura e os campos para um tipo específico de metadados.

apphub.googleapis.com/AgentProperties

Esse esquema é usado para descrever as propriedades de um agente de IA, permitindo que outros sistemas o encontrem e entendam. Normalmente, ele é aplicado a cargas de trabalho que têm uma propriedade de tipo funcional AGENT. O esquema é compatível com o card do agente Agent2Agent (A2A).

Definição do esquema

Confira abaixo o esquema desse tipo de metadados no formato 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"
            }
          }
        }
      }
    }
  }
}

Descrições de campo

Campo Tipo Descrição
displayName string O nome de exibição do agente.
description string A descrição do agente.
version string A versão do agente.
framework string A estrutura usada para desenvolver o agente.
agentCardUri string O URI do card do agente.
skills array Uma lista de habilidades do agente.
skills.id string Um identificador exclusivo da habilidade do agente.
skills.name string Um nome legível para a habilidade do agente.
skills.description string Uma descrição da habilidade do agente.
skills.tags array de string Um conjunto de palavras-chave que descrevem as capacidades da habilidade.
skills.examples array de string Exemplos de comandos ou cenários que essa habilidade pode processar.