Schemi di metadati estesi

App Hub aggiunge automaticamente metadati estesi ad alcuni servizi e workload per migliorare la rilevabilità, la governance e l'integrazione con altri sistemi. Una chiave univoca identifica ogni schema supportato e definisce la struttura e i campi per un tipo specifico di metadati. Per visualizzare questi metadati, consulta Visualizza gli schemi dei metadati estesi.

apphub.googleapis.com/AgentProperties

Questo schema viene utilizzato per descrivere le proprietà di un agente AI, consentendo ad altri sistemi di trovarlo e comprenderlo. In genere viene applicato ai workload che hanno una proprietà di tipo funzionale AGENT. Lo schema è compatibile con la scheda agente Agent2Agent (A2A).

Definizione schema

Di seguito è riportato lo schema per questo tipo di metadati in 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"
            }
          }
        }
      }
    }
  }
}

Descrizioni dei campi

Campo Tipo Descrizione
displayName string Il nome visualizzato dell'agente.
description string La descrizione dell'agente.
version string La versione dell'agente.
framework string Il framework utilizzato per sviluppare l'agente.
agentCardUri string L'URI della scheda agente per l'agente.
skills array Un elenco di skill possedute dall'agente.
skills.id string Un identificatore univoco per la competenza dell'agente.
skills.name string Un nome leggibile per la skill dell'agente.
skills.description string Una descrizione della skill dell'agente.
skills.tags array di string Un insieme di parole chiave che descrivono le funzionalità della skill.
skills.examples array di string Prompt o scenari di esempio che questa skill può gestire.