Schemi di metadati estesi

Questa pagina fornisce un catalogo degli schemi supportati per la proprietà dei metadati estesi su servizi e carichi di lavoro. I metadati estesi aggiungono dati strutturati avanzati ai componenti dell'applicazione App Hub, fornendo il contesto per la governance, le operazioni e l'integrazione con altri sistemi.

Ogni schema è identificato da una chiave univoca e definisce la struttura e i campi per un tipo specifico di metadati.

apphub.googleapis.com/AgentProperties

Questo schema viene utilizzato per descrivere le proprietà di un agente AI, consentendo ad altri sistemi di trovarlo e comprenderlo. Viene in genere applicato ai carichi di lavoro con una proprietà di tipo funzionale AGENT. Lo schema è compatibile con la scheda dell'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 dell'agente.
skills array Un elenco delle competenze dell'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 competenza dell'agente.
skills.tags array di string Un insieme di parole chiave che descrivono le funzionalità della skill.
skills.examples array di string Esempi di prompt o scenari che questa skill può gestire.