Esquemas de metadatos extendidos

Versión preliminar

Este producto o función está sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles sin modificaciones y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En esta página, se proporciona un catálogo de los esquemas admitidos para la propiedad de metadatos extendidos en servicios y cargas de trabajo. Los metadatos extendidos agregan datos enriquecidos y estructurados 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.

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 AGENT. El esquema es compatible con la tarjeta de agente de Agent2Agent (A2A).

Definición de 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	Es el nombre visible del agente.
description	string	La descripción del agente.
version	string	Es la versión del agente.
framework	string	Es el framework que se usó para desarrollar el agente.
agentCardUri	string	Es el URI de la tarjeta del agente.
skills	array	Es una lista de las habilidades que posee el agente.
skills.id	string	Es un identificador único para la habilidad del agente.
skills.name	string	Es un nombre legible para la habilidad del agente.
skills.description	string	Es una descripción de la habilidad del agente.
skills.tags	array de string	Es un conjunto de palabras clave que describen las capacidades de la skill.
skills.examples	array de string	Ejemplos de instrucciones o situaciones que esta habilidad puede controlar.