Esquemas de metadatos extendidos

El concentrador de aplicaciones agrega automáticamente metadatos extendidos a algunos servicios y cargas de trabajo para mejorar la visibilidad, la administración y la integración con otros sistemas. Una clave única identifica cada esquema compatible y define la estructura y los campos para un tipo específico de metadatos. Para ver estos metadatos, consulta Visualiza 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 lo 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 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 usa 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 por humanos para la habilidad del agente.
skills.description string Es 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 Son ejemplos de instrucciones o situaciones que esta habilidad puede controlar.