Configurer Agent Registry

Pour enregistrer et découvrir vos agents IA, vos serveurs MCP (Model Context Protocol), vos compétences autonomes et vos points de terminaison dans Agent Registry, vous devez activer l'API Agent Registry dans votre projet Google Cloud . Le projet dans lequel vous activez le registre d'agents sert de projet de gouvernance. Le projet de gouvernance du registre d'agents vous permet de découvrir automatiquement les charges de travail compatibles déployées dans ce projet et d'enregistrer manuellement les composants distants hébergés dans des projets Google Cloud distincts, des environnements sur site ou des clouds externes.

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 Google Cloud CLI

Si vous prévoyez d'utiliser la gcloud 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 fenêtre de la console Google Cloud , une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement de shell dans lequel la Google Cloud CLI est déjà installée, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.

  2. Mettez à jour gcloud CLI vers la version la plus récente à l'aide de la commande gcloud components update :

    gcloud components update

  3. Si vous prévoyez d'utiliser les fonctionnalités de la version preview, installez le composant alpha à l'aide de la commande gcloud components install :

    gcloud components install alpha

Activer l'API Agent Registry

Console

Rôles requis pour activer les API

Pour activer des API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez l'obtenir via le 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 à l'aide de la commande gcloud services enable :

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.

Octroyer des autorisations

Pour afficher et gérer les ressources dans Agent Registry, vous devez accorder aux utilisateurs les autorisations Identity and Access Management (IAM) 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 et de rechercher des agents, des serveurs MCP, des outils, des compétences autonomes, des révisions de compétences, des éditeurs, des points de terminaison et des liaisons.
  • Éditeur de l'API Agent Registry (roles/agentregistry.editor) : affichez et modifiez les ressources Agent Registry, y compris l'enregistrement, la mise à jour et la suppression d'agents, de serveurs MCP, d'outils, de points de terminaison, de compétences autonomes et de révisions de compétences.
  • Administrateur de l'API Agent Registry (roles/agentregistry.admin) : effectue toutes les actions sur les ressources Agent Registry, y compris l'enregistrement et la gestion des agents, des serveurs MCP, des outils, des points de terminaison, des compétences autonomes, des révisions de compétences, des liaisons et des stratégies IAM de compétences.
  • Utilisateur Agent Registry (roles/agentregistry.user) : affiche toutes les ressources Agent Registry, et crée, met à jour et supprime des compétences autonomes et des révisions de compétences sans accès Éditeur aux agents, aux serveurs MCP ou aux points de terminaison.

Pour savoir comment attribuer 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 le registre d'agents et supprimer les dépendances de l'ancien projet, désactivez l'API Agent Registry dans l'ancien projet. Une fois que vous avez désactivé l'API Agent Registry dans l'ancien projet, vous pouvez l'activer 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 ne souhaitez plus utiliser Agent Registry, désactivez l'API Agent Registry sur 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

Désactivez l'API Agent Registry dans votre projet à l'aide de la commande gcloud services disable :

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

Remplacez PROJECT_ID par l'ID du projet.

Étapes suivantes