Enregistrer des compétences

Dans Agent Registry, une compétence représente une fonctionnalité exécutable autonome qu'un agent peut posséder. Il contient des instructions dans un fichier SKILL.md, des scripts de code et des composants qui étendent le raisonnement d'un agent. En enregistrant des compétences autonomes dans Agent Registry, vous pouvez gérer, versionner et partager de manière centralisée les capacités des agents d'IA de votre organisation.

Les compétences créées par Google sont visibles immédiatement lorsque vous configurez Agent Registry. Ce document explique comment enregistrer manuellement vos propres compétences autonomes dans Agent Registry.

Avant de commencer

Avant de commencer, configurez Agent Registry. Vous avez besoin de l'ID du projet pour effectuer ces tâches.

Pour utiliser les commandes Google Cloud CLI de ce document, assurez-vous d'avoir configuré votre environnement gcloud CLI.

Rôles requis

Pour obtenir les autorisations nécessaires pour enregistrer des compétences dans le registre d'agents, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

D'autres rôles de l'Agent Registry peuvent également inclure les autorisations requises pour enregistrer et gérer les compétences et leurs révisions. Pour en savoir plus, consultez Rôles et autorisations de l'Agent Registry.

Contraintes liées à la charge utile d'ingestion

Pour enregistrer une skill, vous devez regrouper les fichiers sources de la fonctionnalité dans une archive ZIP. L'archive doit inclure un fichier d'instructions SKILL.md à sa racine. Lors de la phase d'ingestion du processus d'enregistrement de la compétence, Agent Registry valide que la charge utile respecte les contraintes suivantes :

  • Taille de l'archive ZIP : la taille maximale de l'archive compressée est de 500 Ko.
  • Taille totale de la charge utile non compressée : la taille non compressée ne doit pas dépasser 10 Mo.
  • Taille de chaque fichier : la taille non compressée de chaque fichier ne doit pas dépasser 1 Mo.
  • Imbrication profonde : la profondeur maximale d'imbrication des répertoires est de huit niveaux.
  • Conformité de la spécification : le fichier SKILL.md doit contenir une section d'en-tête YAML valide définissant le nom, la description et les métadonnées, comme indiqué dans la spécification des compétences de l'agent.

Enregistrer une compétence

Les compétences créées par Google sont visibles immédiatement lorsque vous configurez Agent Registry. Toutefois, vous pouvez également enregistrer manuellement vos propres compétences. Chaque skill possède une révision par défaut et peut contenir plusieurs révisions de skill avec des numéros de version.

Pour enregistrer vos propres compétences, vous devez créer un conteneur de compétences logiques et importer la charge utile de la révision initiale en une seule opération. Vous pourrez ensuite gérer vos compétences enregistrées et leurs révisions.

Pour en savoir plus sur les tarifs et les coûts des fonctionnalités pour les compétences, consultez Tarifs du Registre d'agents.

Les skills que vous ou d'autres utilisateurs créez sont automatiquement attribués à l'éditeur private par défaut pour éviter les conflits de noms avec les skills créés par Google. C'est pourquoi l'ID publié d'une compétence particulière devient private-SKILL_ID. Vous ne pouvez pas spécifier d'éditeur personnalisé lors de la création d'une skill.

Par exemple, si vous créez une skill avec l'ID workspace-tools, le nom de la ressource est créé sous la forme projects/PROJECT_ID/locations/LOCATION/skills/private-workspace-tools. Le nom de ressource uniforme (URN) logique est attribué sous la forme urn:skill:projects-PROJECT_NUMBER:locations:LOCATION:private-workspace-tools. Vous devez utiliser cet ID publié (private-workspace-tools) pour toutes les opérations ultérieures sur la skill.

Pour enregistrer une skill :

Console

  1. Dans la console Google Cloud , accédez à la page Registre d'agents :

    Accéder au registre d'agents

  2. Dans le sélecteur de projets, sélectionnez votre projet Google Cloud .

  3. Sélectionnez l'onglet Compétences.

  4. Dans l'onglet Compétences, le bouton Ajouter une compétence affiche deux options. Vous pouvez choisir l'une des options suivantes :

    • Ajouter une compétence : créez un conteneur de compétences dans le registre. Vous pouvez éventuellement importer un package de skill pour créer la première révision.
    • Importer une compétence : intégrez un nouveau package de compétences personnalisées en important un dossier ZIP contenant votre code ou un fichier d'instructions de prompt (SKILL.md).

  5. Dans le panneau Créer une compétence ou Importer une compétence, spécifiez les informations suivantes :

    • Nom à afficher : saisissez un nom convivial pour la compétence.
    • Description : saisissez un bref résumé expliquant les capacités de la compétence.
    • Emplacement : sélectionnez la région géographique, par exemple global, us ou eu.

  6. Dans la section Source de la charge utile, sélectionnez l'une des options suivantes :

    • Fichier : faites glisser le fichier ZIP de votre skill packagée ou parcourez votre répertoire local.

    • Bucket : saisissez le chemin d'accès à votre archive ZIP stockée dans un bucket Cloud Storage, au format gs://BUCKET_NAME/SKILL_PACKAGE.zip.

  7. Cliquez sur Créer.

Votre skill est créé. Pour toutes les opérations ultérieures sur la skill, faites référence à votre skill en tant que private-SKILL_ID, comme indiqué dans la consoleGoogle Cloud .

gcloud

Pour enregistrer une skill et importer sa charge utile initiale, vous pouvez importer un fichier ZIP local ou un package stocké dans Cloud Storage.

Remplacez les éléments suivants :

  • SKILL_ID : ID de ressource de la compétence, par exemple workspace-docs-skill. Une fois le registre créé, il ajoute automatiquement le préfixe private-. Vous devez utiliser l'ID avec le préfixe dans toutes les commandes de compétence suivantes, par exemple private-workspace-docs-skill.
  • PROJECT_ID : ID du projet.
  • LOCATION : région géographique, par exemple global, us ou eu.
  • DISPLAY_NAME : nom convivial de la compétence.

  • DESCRIPTION : bref résumé expliquant les capacités de la compétence.

  • Importer un fichier ZIP local : pour enregistrer une skill à l'aide d'une charge utile ZIP locale :

    gcloud alpha agent-registry skills create SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION \
  --display-name="DISPLAY_NAME" \
  --description="DESCRIPTION" \
  --payload="LOCAL_ZIP_PATH"

    Remplacez LOCAL_ZIP_PATH par le chemin d'accès à l'archive de votre skill packagée sur votre ordinateur local, par exemple ./workspace-docs-skill.zip.

  • Importer depuis un bucket Cloud Storage : pour enregistrer une skill à l'aide d'une archive ZIP hébergée dans un bucket Cloud Storage :

    gcloud alpha agent-registry skills create SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION \
  --display-name="DISPLAY_NAME" \
  --description="DESCRIPTION" \
  --gcs-source-uri="gs://BUCKET_NAME/SKILL_PACKAGE.zip"

    Remplacez les éléments suivants :

    • BUCKET_NAME : nom du bucket Cloud Storage contenant le bundle ZIP.
    • SKILL_PACKAGE : nom du package de compétences contenant la charge utile de la compétence.

REST

Pour créer une compétence avec une révision initiale intégrée :

Méthode HTTP et URL :

POST https://agentregistry.googleapis.com/v1alpha/projects/{project}/locations/{location}/skills?skillId={skillId}

Corps JSON de la requête (importation de fichier local)

Pour créer une skill en important directement les octets d'une archive ZIP locale, utilisez la charge utile archiveUploadSource :

{
  "displayName": "DISPLAY_NAME",
  "description": "DESCRIPTION",
  "type": "SIMPLE",
  "targetState": "TARGET_STATE_ACTIVE",
  "initialRevision": {
    "archiveUploadSource": {
      "archiveContent": "BASE64_ZIP_BYTES"
    }
  }
}

Remplacez BASE64_ZIP_BYTES par la représentation sous forme de chaîne encodée en base64 de votre archive ZIP locale.

Corps JSON de la requête (importer depuis Cloud Storage)

Vous pouvez également créer une skill à l'aide d'une archive stockée dans un bucket Cloud Storage en utilisant gcsSource :

{
  "displayName": "DISPLAY_NAME",
  "description": "DESCRIPTION",
  "type": "SIMPLE",
  "targetState": "TARGET_STATE_ACTIVE",
  "initialRevision": {
    "gcsSource": {
      "uri": "gs://BUCKET_NAME/SKILL_PACKAGE.zip"
    }
  }
}

Remplacez les éléments suivants :

  • BUCKET_NAME : nom du bucket Cloud Storage contenant le bundle ZIP.
  • SKILL_PACKAGE : nom du package de compétences contenant la charge utile de la compétence.

Commande curl (importation de fichier local)

curl -X POST \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      -d '{
        "displayName": "DISPLAY_NAME",
        "description": "DESCRIPTION",
        "type": "SIMPLE",
        "targetState": "TARGET_STATE_ACTIVE",
        "initialRevision": {
          "archiveUploadSource": {
            "archiveContent": "$(base64 -w0 local_skill.zip)"
          }
        }
      }' \
      "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills?skillId=SKILL_ID"

Pour importer un fichier de bucket Cloud Storage, remplacez le corps JSON de la requête par les champs et valeurs correspondants.

Étapes suivantes