Esquemas de metadados alargados

Esta página apresenta um catálogo dos esquemas suportados para a propriedade de metadados expandidos em serviços e cargas de trabalho. Os metadados alargados adicionam dados estruturados e detalhados aos componentes da aplicação do App Hub, fornecendo contexto para a governação, as operações e a integração com outros sistemas.

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

apphub.googleapis.com/AgentProperties

Este esquema é usado para descrever as propriedades de um agente de IA, permitindo que outros sistemas o encontrem e compreendam. Normalmente, aplica-se a cargas de trabalho que têm uma propriedade de tipo funcional de AGENT. O esquema é compatível com o cartão de agente de agente para agente (A2A).

Definição do esquema

Segue-se o esquema deste 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 dos campos

Campo Tipo Descrição
displayName string O nome a apresentar 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 cartão do agente para o agente.
skills array Uma lista de competências que o agente possui.
skills.id string Um identificador exclusivo da capacidade do agente.
skills.name string Um nome legível para a competência do agente.
skills.description string Uma descrição da capacidade do agente.
skills.tags array de string Um conjunto de palavras-chave que descrevem as capacidades da skill.
skills.examples array de string Exemplos de comandos ou cenários que esta capacidade pode processar.