Configurer Agent Registry

Pour enregistrer et découvrir vos agents IA, vos serveurs MCP (Model Context Protocol) et vos points de terminaison 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 via 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 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. Assurez-vous que la dernière version de gcloud 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 de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation grâce au rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation grâce au rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). 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 votre ID de 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 ressources dans Agent Registry, vous devez accorder aux utilisateurs les autorisations IAM (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 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 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 l'outil de sélection 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