Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Gérer les compétences

Le registre d'agents vous permet d'inspecter, de mettre à jour et de gérer les compétences autonomes afin de contrôler les versions et les états du cycle de vie des compétences disponibles pour vos agents. Après avoir enregistré une compétence autonome, vous pouvez afficher ses détails, modifier sa description ou sa révision par défaut, changer l'état de son cycle de vie ou la supprimer du registre d'agents. Vous pouvez également lister et afficher les compétences gérées par Google, qui sont disponibles dès que vous configurez le registre d'agents.

Avant de commencer

Configurer le registre d'agents.
Obtenez l'ID du projet pour le projet de gouvernance dans lequel Agent Registry est activé.
Enregistrer une compétence autonome
Pour utiliser les commandes de la Google Cloud CLI dans ce document, configurez votre environnement gcloud CLI.

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les compétences dans le registre d'agents, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet de gouvernance où le registre d'agents est activé :

Lister et afficher les compétences : Lecteur de l'API Agent Registry (roles/agentregistry.viewer)
Mettre à jour, modifier les états du cycle de vie et supprimer des compétences : Utilisateur du registre d'agents (roles/agentregistry.user)
Gérer les compétences et les autres ressources Agent Registry : Éditeur de l'API Agent Registry (roles/agentregistry.editor)

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 Agent Registry peuvent également inclure les autorisations requises pour afficher, mettre à jour et supprimer des compétences. Pour en savoir plus, consultez Rôles et autorisations Agent Registry.

Lister et afficher les compétences

Vous pouvez parcourir toutes les compétences enregistrées ou rechercher des capacités spécifiques :

Console

Dans la console Google Cloud , accédez à la page Registre d'agents :
Accéder au registre d'agents
Sélectionnez l'onglet Compétences.
Examinez la liste des compétences. Vous pouvez filtrer l'affichage à l'aide des menus Emplacement ou État.
Cliquez sur le nom d'une compétence pour ouvrir sa page Détails de la compétence, qui affiche le nom, la description, la version active, l'identifiant de la compétence, la date de la dernière mise à jour, les métadonnées personnalisées et l'historique des révisions.

gcloud

Pour lister toutes les compétences d'un emplacement, utilisez la commande gcloud alpha agent-registry skills list :

gcloud alpha agent-registry skills list \
    --project=PROJECT_ID \
    --location=LOCATION

Pour afficher les détails d'une compétence spécifique, utilisez la commande gcloud alpha agent-registry skills describe :

gcloud alpha agent-registry skills describe SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION

Remplacez les éléments suivants :

SKILL_ID : ID de la compétence que vous souhaitez examiner. Pour les compétences enregistrées manuellement, incluez le préfixe private-, par exemple private-my-skill.
PROJECT_ID : ID du projet.
LOCATION : emplacement du registre.

REST

Pour récupérer la liste de toutes les compétences, envoyez une requête GET :

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills"

Pour récupérer un seul conteneur de compétences, envoyez une requête GET :

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID"

Remplacez les éléments suivants :

PROJECT_ID : ID du projet.
LOCATION : emplacement du registre.
SKILL_ID : ID de la compétence que vous souhaitez examiner. Pour les compétences enregistrées manuellement, incluez le préfixe private-, par exemple private-my-skill.

Mettre à jour les métadonnées ou la révision par défaut d'une compétence

Vous pouvez modifier le nom à afficher ou la description d'une compétence, ou modifier manuellement le pointeur de révision par défaut pour déployer une autre version. Pour créer des révisions de compétences, consultez Gérer les révisions de compétences.

Pour mettre à jour les métadonnées d'une compétence ou la révision par défaut d'une compétence particulière, procédez comme suit :

Console

Dans la console Google Cloud , accédez à la page Registre d'agents :
Accéder au registre d'agents
Sélectionnez l'onglet Compétences.
Examinez la liste des compétences. Vous pouvez filtrer l'affichage à l'aide des menus Emplacement ou État.
Cliquez sur le nom d'une compétence pour ouvrir sa page Détails de la compétence, qui affiche le nom, la description, la version active, l'identifiant de la compétence, la date de la dernière mise à jour, les métadonnées personnalisées et l'historique des révisions.
Choisissez l'une des options suivantes :
- Mettre à jour les métadonnées d'une compétence :
  1. Cliquez sur Modifier.
  2. Dans le panneau Modifier la compétence, modifiez le nom à afficher ou la description de votre compétence.
  3. Cliquez sur Enregistrer.
- Mettez à jour la révision par défaut :
  1. Recherchez le tableau Historique des versions.
  2. Recherchez la révision que vous souhaitez activer.
  3. Dans la colonne Actions, cliquez sur Activer la version.

gcloud

Pour mettre à jour les métadonnées d'une compétence, utilisez la commande gcloud alpha agent-registry skills update :

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

Pour mettre à jour la révision de diffusion par défaut d'une compétence, utilisez la commande gcloud alpha agent-registry skills update et spécifiez le nom de ressource de la révision cible :

gcloud alpha agent-registry skills update SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --default-revision="projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID"

Remplacez les éléments suivants :

SKILL_ID : ID de la compétence que vous souhaitez mettre à jour. Pour les compétences enregistrées manuellement, incluez le préfixe private-, par exemple private-my-skill.
PROJECT_ID : ID du projet.
LOCATION : emplacement du registre.
DISPLAY_NAME : nom à afficher mis à jour.
DESCRIPTION : description mise à jour.
REVISION_ID : ID de la révision de compétence que vous souhaitez définir par défaut.

REST

Envoyez une requête PATCH en spécifiant les champs que vous souhaitez mettre à jour :

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
        "displayName": "DISPLAY_NAME",
        "description": "DESCRIPTION",
        "defaultRevision": "projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID"
      }' \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?updateMask=displayName,description,defaultRevision"

Remplacez les éléments suivants :

DISPLAY_NAME : nom à afficher mis à jour de la compétence.
DESCRIPTION : description mise à jour de la compétence.
PROJECT_ID : ID du projet.
LOCATION : emplacement du registre.
SKILL_ID : ID de la compétence que vous souhaitez mettre à jour. Pour les compétences enregistrées manuellement, incluez le préfixe private-, par exemple private-my-skill.
REVISION_ID : ID de la révision de compétence que vous souhaitez activer.

Gérer les états du cycle de vie des compétences

Pour contrôler la façon dont une compétence est résolue au moment de l'exécution, vous pouvez modifier son état cible :

Active : la compétence est diffusée et entièrement résoluble. Pour définir une compétence sur Active, son champ defaultRevision doit pointer vers une révision de compétence active.
Désactivé : état initial par défaut lorsqu'une compétence est créée. La compétence n'est pas diffusée au moment de l'exécution, la résolution de la compétence échoue immédiatement et les téléchargements de charges utiles sont bloqués. Une compétence est également placée à l'état Désactivé si son pointeur defaultRevision est effacé ou si sa révision par défaut est supprimée. Contrairement à l'état Mis hors service, vous pouvez activer une compétence désactivée en définissant un defaultRevision valide et en définissant son état cible sur Actif.
Obsolète : la compétence peut toujours être chargée et téléchargée, mais elle indique qu'elle sera mise hors service.
Mis hors service : la compétence est désactivée de manière permanente, n'est plus diffusée et ne peut pas être rétablie à l'état Actif ou à tout autre état. Une compétence ne peut être mise hors service qu'après avoir été obsolète. Prévoyez suffisamment de temps pour effectuer la migration avant de mettre hors service la compétence. Comme cet état est terminal, utilisez-le avec précaution.

Pour modifier l'état du cycle de vie d'une compétence :

Console

Dans la console Google Cloud , accédez à la page Registre d'agents :
Accéder au registre d'agents
Sélectionnez l'onglet Compétences.
Examinez la liste des compétences. Vous pouvez filtrer l'affichage à l'aide des menus Emplacement ou État.
Cliquez sur le nom d'une compétence pour ouvrir sa page Détails de la compétence, qui affiche le nom, la description, la version active, l'identifiant de la compétence, la date de la dernière mise à jour, les métadonnées personnalisées et l'historique des révisions.
Utilisez les boutons de contrôle de l'état pour modifier l'état de la cible. Les boutons affichés sur la page dépendent de l'état actuel de la compétence, par exemple Activer, Désactiver, Abandonner ou Mettre hors service.

gcloud

Mettez à jour le conteneur de compétences à l'aide de la commande gcloud alpha agent-registry skills update et de l'option --target-state :

gcloud alpha agent-registry skills update SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --target-state=DISABLED

Remplacez les éléments suivants :

SKILL_ID : ID de la compétence que vous souhaitez mettre à jour. Pour les compétences enregistrées manuellement, incluez le préfixe private-, par exemple private-my-skill.
PROJECT_ID : ID du projet.
LOCATION : emplacement du registre.

Les valeurs autorisées pour l'état cible sont les suivantes :

ACTIVE
DISABLED
DEPRECATED
DECOMMISSIONED

REST

Envoyez une requête PATCH en spécifiant targetState dans le corps et dans le masque de mise à jour :

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
      "targetState": "TARGET_STATE_DISABLED"
    }' \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?updateMask=targetState"

Remplacez les éléments suivants :

PROJECT_ID : ID du projet.
LOCATION : emplacement du registre.
SKILL_ID : ID de la compétence que vous souhaitez mettre à jour. Pour les compétences enregistrées manuellement, incluez le préfixe private-, par exemple private-my-skill.

Les valeurs autorisées pour l'état cible sont les suivantes :

TARGET_STATE_ACTIVE
TARGET_STATE_DISABLED
TARGET_STATE_DEPRECATED
TARGET_STATE_DECOMMISSIONED

Supprimer une compétence

La suppression d'un conteneur de compétences supprime définitivement la ressource Skill et toutes les ressources SkillRevision immuables associées. Les agents qui tentent de résoudre l'identifiant de compétence supprimé échouent au moment de l'exécution.

Console

Dans la console Google Cloud , accédez à la page Registre d'agents :
Accéder au registre d'agents
Sélectionnez l'onglet Compétences.
Examinez la liste des compétences. Vous pouvez filtrer l'affichage à l'aide des menus Emplacement ou État.
Cliquez sur le nom de la compétence que vous souhaitez supprimer.
Sur la page Détails de la compétence, cliquez sur Supprimer.
Dans la boîte de dialogue de confirmation, saisissez DELETE, puis cliquez sur Supprimer.

gcloud

Pour supprimer une compétence, utilisez la commande gcloud alpha agent-registry skills delete :

gcloud alpha agent-registry skills delete SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION

Remplacez les éléments suivants :

SKILL_ID : ID de la compétence que vous souhaitez supprimer. Pour les compétences enregistrées manuellement, incluez le préfixe private-, par exemple private-my-skill.
PROJECT_ID : ID du projet.
LOCATION : emplacement du registre.

REST

Pour supprimer une compétence, envoyez une requête DELETE :

curl -X DELETE \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?force=true"

Remplacez les éléments suivants :

PROJECT_ID : ID du projet.
LOCATION : emplacement du registre.
SKILL_ID : ID de la compétence que vous souhaitez supprimer. Pour les compétences enregistrées manuellement, incluez le préfixe private-, par exemple private-my-skill.

Étapes suivantes

Découvrez comment importer de nouvelles révisions et télécharger des packages.
Comprendre les rôles et autorisations pour gérer les compétences

Gérer les compétences Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Avant de commencer

Rôles requis

Lister et afficher les compétences

Console

gcloud

REST

Mettre à jour les métadonnées ou la révision par défaut d'une compétence

Console

gcloud

REST

Gérer les états du cycle de vie des compétences

Console

gcloud

REST

Supprimer une compétence

Console

gcloud

REST

Étapes suivantes

Gérer les compétences