Panoramica del registro delle skill

Skill Registry funge da repository sicuro, privato e a bassa latenza per la gestione delle competenze 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, il Registro delle competenze consente agli agenti di scoprire e caricare dinamicamente le funzionalità più pertinenti in base all'intent dell'utente, ottimizzando così il rendimento 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 competenze prevista, consulta i file SKILL.md nel repository Google Cloud Skills.
Revisione delle competenze Uno snapshot immutabile di una versione specifica dell'abilità. Include un nome, una descrizione e un riferimento immutabile alla risorsa skill padre.

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 va a buon fine e viene restituito un errore di convalida se il sistema rileva uno dei seguenti problemi:

  • 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 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 è 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 manca il frontespizio YAML obbligatorio o il contenuto Markdown previsto.
    • Il campo del nome nel frontespizio YAML è mancante, supera i 64 caratteri, inizia o termina con un trattino oppure contiene caratteri diversi da lettere minuscole, numeri e trattini.
    • Il campo della descrizione nel frontmatter YAML è mancante o supera i 1024 caratteri.
    • Il campo della licenza nel frontmatter 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.

Competenze integrate

Skill Registry include una skill gcp-skill-registry integrata. Questa competenza consente agli agenti di interagire con il Registro delle competenze 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, il rilascio e il controllo delle versioni di questa skill integrata, garantendo la funzionalità predefinita.

Passaggi successivi

Guida

Scopri come creare, aggiornare, cercare ed eliminare le skill nel registro delle skill.