Esquemas de metadatos ampliados

Vista previa

Este producto o función está sujeto a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Los productos y las funciones previos a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

En esta página se ofrece un catálogo de los esquemas admitidos para la propiedad de metadatos extendidos en servicios y cargas de trabajo. Los metadatos ampliados añaden datos estructurados y completos a los componentes de las aplicaciones de App Hub, lo que proporciona contexto para la gestió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 de un tipo específico de metadatos.

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 lo entiendan. Se suele aplicar a cargas de trabajo que tienen una propiedad de tipo funcional AGENT. El esquema es compatible con la tarjeta de agente de Agent2Agent (A2A).

Definición del esquema

A continuación, se muestra el esquema de 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	Nombre visible del agente.
description	string	La descripción del agente.
version	string	Versión del agente.
framework	string	El framework usado para desarrollar el agente.
agentCardUri	string	El URI de la tarjeta del agente.
skills	array	Una lista de las habilidades del agente.
skills.id	string	Identificador único de la habilidad del agente.
skills.name	string	Nombre legible de 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 funciones de la skill.
skills.examples	array de string	Ejemplos de peticiones o situaciones que puede gestionar esta habilidad.