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 Skill Registry permet aux agents de découvrir et de charger dynamiquement les capacités les plus pertinentes en fonction de l'intention de l'utilisateur, optimisant ainsi les performances et garantissant un environnement d'exécution sécurisé.
Concepts clés
Skill Registry introduit deux entités d'API standards de premier niveau pour gérer le cycle de vie et le versionnage :
| Concept | Description |
|---|---|
| Compétence |
Entité mutable de premier niveau contenant des métadonnées (telles que le nom à afficher, les codes temporels de création et de mise à jour, et les libellés), la révision par défaut et le contenu de la skill.
Pour obtenir des exemples de la structure de compétence attendue, consultez les fichiers SKILL.md dans le dépôt Google Cloud Skills.
|
| Révision des compétences | Instantané immuable d'une version spécifique d'une compétence. 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 skill
Pour s'assurer que les agents peuvent utiliser du 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 valide ou il manque des informations importantes.
- 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 fichiers ou des dossiers qui portent le même nom.
- La taille totale de tous les fichiers dans le fichier ZIP dépasse 500 Mo une fois décompressé.
- Le fichier est trop compressé (taux de compression supérieur à 100).
- Les dossiers du fichier ZIP sont imbriqués sur plus de huit niveaux.
- 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 contenu YAML requis ou le contenu Markdown attendu. - Le champ "name" (nom) est manquant dans le front matter YAML, 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 de description dans le frontmatter YAML est manquant ou dépasse 1 024 caractères.
- Le champ de licence dans le fichier YAML dépasse 1 024 caractères.
- Les instructions du fichier
SKILL.mddépassent 500 000 caractères.
- Le fichier
- L'archive compressée dépasse 10 Mo.
Compétences intégrées
Skill Registry inclut une compétence gcp-skill-registry intégrée. Cette compétence permet aux agents d'interagir avec le Skill Registry pour créer, rechercher et gérer les compétences disponibles. Ils peuvent ainsi enregistrer de nouvelles fonctionnalités ou découvrir des capacité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.
Étapes suivantes
Créer et gérer des compétences
Découvrez comment créer, mettre à jour, rechercher et supprimer des compétences dans le Skill Registry.