Esquemas de metadados estendidos

O App Hub adiciona automaticamente metadados estendidos a alguns serviços e cargas de trabalho para melhorar a facilidade de descoberta, a governança e a integração com outros sistemas. Uma chave exclusiva identifica cada esquema compatível e define a estrutura e os campos para um tipo específico de metadados. Para conferir esses metadados, consulte Ver esquemas de metadados estendidos.

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, ela é aplicada a cargas de trabalho que têm uma propriedade de tipo funcional de AGENT. O esquema é compatível com o card de agente do Agent2Agent (A2A).

Definição do esquema

Veja a seguir o esquema para esse 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 O framework usado para desenvolver o agente.
agentCardUri string O URI do card do agente.
skills array Uma lista de habilidades que o agente possui.
skills.id string Um identificador exclusivo para a 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.