Examiner les informations sur l'éditeur de la compétence

Dans le registre d'agents, les éditeurs vous permettent de vérifier l'autorité derrière les compétences autonomes enregistrées afin d'empêcher l'utilisation non autorisée de leurs noms. Chaque éditeur établit le domaine validé ou le préfixe d'ID pour les identifiants de compétence, par exemple cloud.google.com pour les compétences gérées par Google ou private- pour les compétences enregistrées manuellement.

Google contrôle la création, la mise à jour et la suppression des éditeurs. Les compétences que vous créez sont automatiquement attribuées à l'éditeur private par défaut, qui utilise le préfixe private-. Vous pouvez lister et inspecter les détails de l'éditeur dans le registre d'agents pour vérifier la propriété des compétences enregistrées.

Avant de commencer

  1. Configurer le registre d'agents.

  2. Pour une configuration à projet unique, obtenez l'ID de projet du projet de gouvernance où le registre d'agents est activé. Si vous avez configuré une limite de gestion pour plusieurs projets, utilisez l'ID de votre projet de gestion pour la découverte et l'enregistrement à l'échelle de la limite, ou spécifiez l'ID d'un projet membre pour les opérations sur un seul projet.

  3. Enregistrer une compétence autonome

  4. 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 examiner les détails de l'éditeur de compétences dans Agent Registry, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de l'API Agent Registry (roles/agentregistry.viewer) sur le projet de gouvernance où Agent Registry est activé. 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 du registre d'agents peuvent également inclure les autorisations requises pour afficher les détails de l'éditeur de compétences. Pour en savoir plus, consultez Rôles et autorisations Agent Registry.

Niveaux d'éditeur

Les éditeurs sont classés en fonction de leur niveau de validation :

  • Gérés par Google (FIRST_PARTY) : éditeurs validés gérés par Google, tels que cloud.google.com et discoveryengine.googleapis.com.
  • Privé (PRIVATE) : éditeur private par défaut automatiquement attribué aux compétences que vous ou d'autres utilisateurs créez dans le projet.

Lister les éditeurs

Vous pouvez lister tous les éditeurs configurés dans votre emplacement :

Console

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

    Accéder au registre d'agents

  2. Sélectionnez l'onglet Compétences. La page affiche la liste de toutes vos compétences enregistrées.
  3. Dans la colonne Éditeur de toutes les compétences enregistrées, vous pouvez parcourir tous les éditeurs validés disponibles que vous avez associés à chacune de vos compétences.

gcloud

Pour lister tous les éditeurs validés d'un emplacement, exécutez la commande gcloud alpha agent-registry publishers list :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet.
  • LOCATION : emplacement du registre.

REST 

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet.
  • LOCATION : emplacement du registre.

Afficher les détails de l'éditeur

Vous pouvez inspecter les détails d'un éditeur spécifique :

Console

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

    Accéder au registre d'agents

  2. Sélectionnez l'onglet Compétences.
  3. Cliquez sur le nom d'une compétence pour ouvrir sa page d'informations.

  4. Dans la section Skill details (Détails de la compétence), recherchez l'identifiant de la compétence.

    Utilisez ce champ d'identifiant de compétence pour trouver les assets d'un éditeur spécifique. Par exemple, le format des compétences gérées par Google est urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID.

gcloud

Pour afficher les détails d'un éditeur spécifique, exécutez la commande gcloud alpha agent-registry publishers describe :

gcloud alpha agent-registry publishers describe PUBLISHER_ID \
    --project=PROJECT_ID \
    --location=LOCATION

Remplacez les éléments suivants :

  • PUBLISHER_ID : ID de l'éditeur que vous souhaitez examiner.
  • PROJECT_ID : ID du projet.
  • LOCATION : emplacement du registre.

REST 

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet.
  • LOCATION : emplacement du registre.
  • PUBLISHER_ID : ID de l'éditeur que vous souhaitez examiner.

Étapes suivantes