Esquemas de metadatos extendidos

En esta página, se proporciona un catálogo de los esquemas compatibles para la propiedad de metadatos extendidos propiedad en servicios y cargas de trabajo. Los metadatos extendidos agregan datos estructurados y enriquecidos a los componentes de la aplicación de App Hub, lo que proporciona contexto para la administración, las operaciones y la integración con otros sistemas.

Cada esquema se identifica con una clave única y define la estructura y los campos para un tipo específico de metadatos.

Para obtener información sobre cómo visualizar estos metadatos, consulta Cómo ver esquemas de metadatos extendidos.

apphub.googleapis.com/AgentProperties

Este esquema se usa para describir las propiedades de un agente de IA, lo que permite que otros sistemas lo encuentren y comprendan. Por lo general, se aplica a las cargas de trabajo que tienen una propiedad de tipo funcional de AGENT. El esquema es compatible con la tarjeta de agente de Agent2Agent (A2A).

Definición de esquema

A continuación, se muestra el esquema para este tipo de metadatos en 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"
            }
          }
        }
      }
    }
  }
}

Descripciones de los campos

Campo Tipo Descripción
displayName string El nombre visible del agente.
description string La descripción del agente.
version string La versión del agente.
framework string El framework que se usó para desarrollar el agente.
agentCardUri string El URI de la tarjeta de agente para el agente.
skills array Una lista de las habilidades que posee el agente.
skills.id string Un identificador único para la habilidad del agente.
skills.name string Un nombre legible por humanos para la habilidad del agente.
skills.description string Una descripción de la habilidad del agente.
skills.tags array de string Un conjunto de palabras clave que describen las capacidades de la habilidad.
skills.examples array de string Ejemplos de mensajes o situaciones que esta habilidad puede controlar.