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 skill, Skill Registry consente agli agenti di scoprire e caricare dinamicamente le funzionalità più pertinenti in base all'intento dell'utente, 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 che contiene 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 SKILL.md file nel repository Google Cloud Skills.
Revisione della skill Uno snapshot immutabile di una versione specifica della 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 delle 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 riesce a causa di un errore di convalida se il sistema rileva uno dei seguenti elementi:

  • Il file non è un file ZIP corretto o mancano informazioni chiave.
  • Il file ZIP è vuoto.
  • Il file ZIP contiene più di 10.000 elementi.
  • I nomi di file o 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 dopo la decompressione.
  • Il file è compresso eccessivamente, con un rapporto di compressione superiore a 100.
  • Le cartelle all'interno del file ZIP superano gli 8 livelli di profondità.
  • Il file ZIP non contiene un file SKILL.md.
  • Il file SKILL.md presenta i seguenti problemi:
    • Nel file SKILL.md mancano i metadati YAML obbligatori o i contenuti Markdown previsti.
    • Il campo name nei metadati 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 nei metadati YAML è mancante o supera i 1024 caratteri.
    • Il campo license nei metadati YAML supera i 1024 caratteri.
    • Le istruzioni nel file SKILL.md superano i 500.000 caratteri.
  • Le dimensioni dell'archivio compresso superano i 10 MB.

Skill integrate

Skill Registry include una skill integrata gcp-skill-registry. 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 le funzionalità esistenti. Google gestisce il ciclo di vita, la release e il controllo delle versioni di questa skill integrata, garantendo funzionalità predefinite.

Passaggi successivi

Guida

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