Le registre de compétences sert de dépôt sécurisé, privé et à faible latence pour gérer les compétences des agents. Chaque compétence est un package autonome, comprenant des instructions structurelles, du code exécutable et de la documentation, conçu pour étendre les capacités d'un agent.
En centralisant ces compétences, le registre de compétences permet aux agents de découvrir et de charger dynamiquement les fonctionnalités les plus pertinentes en fonction de l'intention utilisateur, optimisant ainsi les performances et garantissant un environnement d'exécution sécurisé.
Concepts clés
Le registre de compétences introduit deux entités d'API standards de premier niveau pour gérer le cycle de vie et la gestion des versions :
| Concept | Description |
|---|---|
| Compétence |
Entité mutable de premier niveau contenant des métadonnées (telles que le nom à afficher,
codes temporels de création et de mise à jour, et les libellés), la révision par défaut et
le contenu de la compétence.
Pour obtenir des exemples de la structure de compétence attendue, consultez les SKILL.md fichiers dans le dépôt Google Cloud Skills.
|
| Révision de compétence | Instantané immuable d'une version de compétence spécifique. Il inclut un nom, une description et une référence immuable à la ressource de compétence parente. |
Validation de la charge utile de la compétence
Pour s'assurer que les agents peuvent utiliser un contenu de compétence valide, le système vérifie automatiquement toutes les charges utiles de compétence lors de la création ou des mises à jour. Ces validations sont effectuées de manière asynchrone.
L'opération asynchrone échoue avec une erreur de validation si le système détecte l'un des éléments suivants :
- Le fichier n'est pas un fichier ZIP approprié ou des informations clés sont manquantes.
- Le fichier ZIP est vide.
- Le fichier ZIP contient plus de 10 000 éléments.
- Les noms de fichiers ou de dossiers dans le fichier ZIP contiennent
..ou commencent par/ou\\. - Le fichier ZIP contient des liens symboliques.
- Le fichier ZIP contient des noms de fichiers ou de dossiers en double.
- La taille totale de tous les fichiers dans le fichier ZIP dépasse 500 Mo une fois décompressée.
- Le fichier est trop compressé, avec un taux de compression supérieur à 100.
- Les dossiers dans le fichier ZIP dépassent huit niveaux de profondeur.
- Le fichier ZIP ne contient pas de fichier
SKILL.md. - Le fichier
SKILL.mdprésente les problèmes suivants :- Le fichier
SKILL.mdne contient pas le préambule YAML requis ni le contenu Markdown attendu. - Le champ "name" (nom) du préambule YAML est manquant, dépasse 64 caractères, commence ou se termine par un trait d'union, ou contient des caractères autres que des lettres minuscules, des chiffres et des traits d'union.
- Le champ "description" (description) du préambule YAML est manquant ou dépasse 1 024 caractères.
- Le champ "license" (licence) du préambule YAML dépasse 1 024 caractères.
- Les instructions du fichier
SKILL.mddépassent 500 000 caractères.
- Le fichier
- La taille de l'archive compressée dépasse 10 Mo.
Compétences intégrées
Le registre de compétences inclut une compétence gcp-skill-registry intégrée. Cette compétence permet aux agents d'interagir avec le registre de compétences pour créer, rechercher et gérer les compétences disponibles, ce qui leur permet d'enregistrer de nouvelles fonctionnalités ou de découvrir des fonctionnalités existantes. Google gère le cycle de vie, la publication et la gestion des versions de cette compétence intégrée, ce qui garantit une fonctionnalité prête à l'emploi.
Étape suivante
Créer et gérer des compétences
Découvrez comment créer, mettre à jour, rechercher et supprimer des compétences dans le registre de compétences.