Présentation du registre de compétences

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 des compétences permet aux agents de découvrir et de charger de manière dynamique les fonctionnalités les plus pertinentes en fonction de l'intention utilisateur, ce qui optimise les performances et garantit 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
Skill Entité de premier niveau modifiable 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 compétence.

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 de la 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 de la mise à 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 clés.
  • Le fichier ZIP est vide.
  • Le fichier ZIP contient plus de 10 000 éléments.
  • Les noms de fichiers ou de dossiers du 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 du fichier ZIP dépasse 500 Mo une fois décompressés.
  • Le fichier est trop compressé, avec un taux de compression supérieur à 100.
  • Les dossiers du fichier ZIP comportent plus de huit niveaux d'imbrication.
  • Le fichier ZIP ne contient pas de fichier SKILL.md.
  • Le fichier SKILL.md présente les problèmes suivants :
    • Le fichier SKILL.md ne contient pas le YAML front matter requis ni le contenu Markdown attendu.
    • Le champ "name" 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 de description dans le front matter YAML est manquant ou dépasse 1 024 caractères.
    • Le champ "license" du front matter YAML dépasse 1 024 caractères.
    • Les instructions du fichier SKILL.md dépassent 500 000 caractères.
  • La taille de l'archive ZIP 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 des 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.

Étapes suivantes

Guide

Découvrez comment créer, mettre à jour, rechercher et supprimer des compétences dans le registre des compétences.