Panoramica di Skill Registry

Skill Registry funge da repository sicuro, privato e a bassa latenza per la gestione delle competenze degli agenti. Ogni competenza è 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 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
Competenza 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 competenza.

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

Convalida del payload della competenza

Per garantire che gli agenti possano utilizzare contenuti di competenze validi, il sistema verifica automaticamente tutti i payload delle competenze 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 quando vengono decompressi.
  • 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 competenza integrata gcp-skill-registry. Questa competenza consente agli agenti di interagire con Skill Registry per creare, cercare e gestire le competenze 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 competenza integrata, garantendo funzionalità predefinite.

Passaggi successivi

Guida

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