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

Dans Agent Registry, un éditeur représente une autorité validée qui publie des compétences d'agent. Les éditeurs dictent les préfixes que les compétences peuvent utiliser pour éviter l'usurpation de noms et appliquer la validation de l'identité. Par exemple, le préfixe google- est réservé aux compétences Google validées.

Ce document explique comment examiner et inspecter les détails de l'éditeur validé pour vos compétences enregistrées.

La création, la modification ou la suppression d'éditeurs, ainsi que la gestion des allocations de préfixes validés, sont réservées aux administrateurs internes de Google. Les compétences que vous ou d'autres utilisateurs créez sont automatiquement attribuées à l'éditeur private par défaut. L'ID publié d'une compétence particulière est donc précédé du préfixe private-. Vous ne pouvez pas enregistrer de ressources d'éditeur personnalisées.

Avant de commencer

Avant de commencer, configurez Agent Registry et enregistrez une compétence autonome. Vous aurez 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 examiner les détails de l'éditeur de compétences dans Agent Registry, demandez à votre administrateur de vous accorder lerôle IAM Utilisateur Agent Registry (roles/agentregistry.user) 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.

Niveaux d'éditeur

Les éditeurs sont classés en niveaux qui reflètent leur niveau de validation :

  • Propriétaire (FIRST_PARTY) : éditeurs mondiaux validés et sélectionnés par Google. Par exemple, publishers/cloud.google.com et publishers/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.

Répertorier les éditeurs

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

Console

  1. Dans la Google Cloud console, accédez à la page Agent Registry :

    Accéder à Agent Registry

  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 

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 Google Cloud console, accédez à la page Agent Registry :

    Accéder à Agent Registry

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

  4. Dans la section Détails de la compétence, recherchez le nom de ressource uniforme (URN) de la compétence.

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

gcloud 

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.

Étape suivante