Configurer Agent Registry

Pour enregistrer et découvrir vos agents d'IA et vos serveurs MCP (Model Context Protocol) dans Agent Registry, vous devez activer l'API Agent Registry dans votre Google Cloud projet. Agent Registry 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 Agent Registry 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 afin de configurer Agent Registry, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre Google Cloud 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.

Configurer votre environnement gcloud CLI

Si vous prévoyez d'utiliser Google Cloud CLI pour Agent Registry, procédez comme suit :

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

    Activer Cloud Shell

    En bas de la Google Cloud console, une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement de 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.

Une fois l'API Agent Registry activée, vous pouvez commencer à enregistrer et à découvrir des agents dans ce projet.

Accorder des autorisations

Pour afficher et gérer les ressources dans Agent Registry, 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) : affichez les agents, les outils et leurs attributs.
  • Éditeur de l'API Agent Registry (roles/agentregistry.editor) : modifiez l'accès aux 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 accorder des rôles IAM sur 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 et 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 sur le projet :

Console

  1. Dans la Google Cloud console, 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 Google Cloud projet 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.

Étape suivante