Configurer Agent Registry

Pour enregistrer et découvrir vos agents d'IA et vos serveurs MCP (Model Context Protocol) dans le registre d'agents, vous devez activer l'API Agent Registry dans votre projet Google Cloud. Le registre d'agents fonctionne au niveau du projet, ce qui vous permet de découvrir et de gérer les agents déployés dans le projet spécifique où l'API est activée.

Ce document explique comment configurer le registre d'agents et activer l'API requise.

Avant de commencer

Pour configurer Agent Registry, utilisez un projet existant ou créez-en un.

Rôles requis

Pour obtenir les autorisations nécessaires pour configurer le registre d'agents, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet Google Cloud  :

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.

Configurer votre environnement gcloud CLI

Si vous prévoyez d'utiliser Google Cloud CLI pour le registre d'agents, procédez comme suit :

  1. Dans la console Google Cloud , activez Cloud Shell.

    Activer Cloud Shell

    En bas de la console Google Cloud , une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement shell dans lequel Google Cloud CLI est déjà installé, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.

  2. Installez le composant alpha :

    gcloud components install alpha

  3. Assurez-vous que la dernière version de Google Cloud CLI est installée :

    gcloud components update

Activer l'API Agent Registry

Console

Rôles requis pour activer les API

Pour activer les API, vous avez besoin du rôle IAM Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. Découvrez comment attribuer des rôles.

Activer l'API

gcloud

Activez l'API Agent Registry dans votre projet :

gcloud services enable agentregistry.googleapis.com \
    --project=PROJECT_ID

Remplacez PROJECT_ID par l'ID de votre projet.

Après avoir activé l'API Agent Registry, vous pouvez commencer à enregistrer et à découvrir des agents dans ce projet.

Accorder des autorisations

Pour afficher et gérer les services dans le registre d'agents, vous devez accorder aux utilisateurs les autorisations Identity and Access Management appropriées.

Attribuez à vos utilisateurs un ou plusieurs des rôles Agent Registry suivants :

  • Lecteur de l'API Agent Registry (roles/agentregistry.viewer) : permet d'afficher les agents, les outils et leurs attributs.
  • Éditeur de l'API Agent Registry (roles/agentregistry.editor) : accès permettant de modifier les ressources Agent Registry.
  • Administrateur de l'API Agent Registry (roles/agentregistry.admin) : effectuez toutes les actions, y compris l'enregistrement manuel des agents et la mise à jour des métadonnées.

Pour savoir comment attribuer des rôles IAM à un projet, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Modifier votre projet Agent Registry

Si vous souhaitez modifier le projet dans lequel vous utilisez Agent Registry et supprimer les dépendances de l'ancien projet, désactivez l'API Agent Registry dans ce projet. Vous pouvez ensuite activer l'API Agent Registry dans un autre projet. Vos données ne sont pas migrées. Vous devez recréer vos ressources dans ce nouveau projet.

Désactiver l'API Agent Registry

Si vous n'avez plus besoin d'Agent Registry, désactivez l'API Agent Registry dans le projet :

Console

  1. Dans la console Google Cloud , accédez à la page de gestion de l'API Agent Registry :

    Accéder à l'API Agent Registry

  2. Dans le sélecteur de projets, sélectionnez le projet Google Cloud dans lequel vous avez configuré Agent Registry.

  3. Cliquez sur Désactiver l'API.

  4. Dans la boîte de dialogue de confirmation, cliquez sur Désactiver.

gcloud 

gcloud services disable agentregistry.googleapis.com \
  --project=PROJECT_ID

Remplacez PROJECT_ID par l'ID du projet.

Étapes suivantes