Panoramica di Skill Registry

Skill Registry funge da repository sicuro, privato e a bassa latenza per la gestione delle skill degli agenti. Ogni skill è un pacchetto autonomo, che include istruzioni strutturali, codice eseguibile e documentazione, progettato per estendere le funzionalità di un agente.

Centralizzando queste competenze, Skill Registry consente agli agenti di scoprire e caricare dinamicamente le funzionalità più pertinenti in base allo user intent, ottimizzando così le prestazioni e garantendo un ambiente di esecuzione sicuro.

Concetti fondamentali

Skill Registry introduce due entità API standard di primo livello per gestire il ciclo di vita e il controllo delle versioni:

Concetto Descrizione
Skill Un'entità di primo livello modificabile contenente metadati (come nome visualizzato, timestamp di creazione e aggiornamento ed etichette), la revisione predefinita e i contenuti della skill.

Per esempi della struttura delle skill prevista, consulta i file SKILL.md nel repository Google Cloud Skills.
Revisione della skill Uno snapshot immutabile di una versione specifica di uno skill. Include un nome, una descrizione e un riferimento immutabile alla risorsa skill principale.

Convalida del payload della skill

Per garantire che gli agenti possano utilizzare contenuti di skill validi, il sistema verifica automaticamente tutti i payload delle skill durante la creazione o gli aggiornamenti. Queste convalide vengono eseguite in modo asincrono.

L'operazione asincrona non va a buon fine e restituisce un errore di convalida se il sistema rileva uno dei seguenti elementi:

  • Il file non è un file ZIP valido o mancano informazioni chiave.
  • Il file ZIP è vuoto.
  • Il file ZIP contiene più di 10.000 elementi.
  • I nomi dei file o delle cartelle nel file ZIP contengono .. o iniziano con / o \\.
  • Il file ZIP contiene link simbolici.
  • Nel file ZIP sono presenti nomi di file o cartelle duplicati.
  • Le dimensioni totali di tutti i file all'interno del file ZIP superano i 500 MB quando vengono decompressi.
  • Il file è troppo compresso, con un rapporto di compressione superiore a 100.
  • Le cartelle all'interno del file ZIP hanno più di 8 livelli.
  • Il file ZIP non contiene un file SKILL.md.
  • Il file SKILL.md presenta i seguenti problemi:
    • Nel file SKILL.md manca il front matter YAML obbligatorio o i contenuti Markdown previsti.
    • Il campo del nome nel front matter YAML è mancante, supera i 64 caratteri, inizia o termina con un trattino o contiene caratteri diversi da lettere minuscole, numeri e trattini.
    • Il campo description nel front matter YAML non è presente o supera i 1024 caratteri.
    • Il campo della licenza nel front matter YAML supera i 1024 caratteri.
    • Le istruzioni nel file SKILL.md superano i 500.000 caratteri.
  • Il file ZIP ha dimensioni superiori a 10 MB.

Skill integrate

Skill Registry include una skill gcp-skill-registry integrata. Questa skill consente agli agenti di interagire con Skill Registry per creare, cercare e gestire le skill disponibili, consentendo loro di registrare nuove funzionalità o scoprire quelle esistenti. Google gestisce il ciclo di vita, la release e il controllo delle versioni di questa skill integrata, garantendo una funzionalità immediata.

Passaggi successivi

Guida

Scopri come creare, aggiornare, cercare ed eliminare competenze in Skill Registry.