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.

Vous pouvez configurer le registre d'agents dans un seul projet de gouvernance ou dans plusieurs projets en configurant une limite de gestion où un projet de gestion central sert de projet de gouvernance.

Avant de commencer

Configurez Agent Registry dans un seul projet ou dans plusieurs projets :

• Projet unique : découvrez et gérez les agents, les serveurs MCP, les compétences et les points de terminaison dans un seul projet de gouvernance Google Cloud . Utilisez un projet existant ou créez-en un, activez l'API Agent Registry et accordez des autorisations.
• Plusieurs projets (limite de gestion) : centralisez la découverte et la gouvernance sur plusieurs projets membres de votre hiérarchie de ressourcesGoogle Cloud en associant une limite de gestion à un projet de gestion. Désignez un projet Google Cloud existant comme projet de gestion ou laissez Resource Manager en créer un pour vous, activez l'API Resource Manager, configurez une limite de gestion et accordez des autorisations.

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  :

• Activer l'API Agent Registry : Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin)
• Attribuer des rôles pour utiliser l'API Agent Registry : Administrateur IAM de projet (roles/resourcemanager.projectIamAdmin)
• Accès complet aux ressources de l'API Agent Registry : Administrateur de l'API Agent Registry (roles/agentregistry.admin)

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 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

• Pour un seul projet : activez l'API Agent Registry sur votre projet de gouvernance. Une fois l'API activée et les autorisations accordées, vous pouvez commencer à enregistrer et à découvrir des agents dans ce projet. Vous n'avez pas besoin de configurer une limite de gestion.
• Pour plusieurs projets (limite de gestion) : activez l'API Resource Manager sur le projet que vous utilisez pour exécuter les commandes de configuration. Lorsque vous configurez une limite de gestion pour plusieurs projets et que vous créez la configuration de la fonctionnalité, Resource Manager active automatiquement l'API Agent Registry sur votre projet de gestion.

Utilisez l'ID de votre projet pour activer les API :

Console

Pour un seul projet, activez l'API Agent Registry sur votre projet :

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

Pour plusieurs projets (limite de gestion), activez l'API Resource Manager sur le projet que vous utilisez pour la configuration :

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

• Pour un seul projet, activez l'API Agent Registry sur votre projet à l'aide de la commande gcloud services enable :

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

• Pour plusieurs projets (limite de gestion), activez l'API Resource Manager sur le projet que vous utilisez pour la configuration :

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

Remplacez PROJECT_ID par l'ID de projet de votre projet de gouvernance autonome ou du projet que vous souhaitez utiliser comme projet de gestion pour votre limite de gestion.

Remarque : Si vous intégrez Agent Registry à Agent Gateway pour l'application des règles, vous devez également activer l'API Identity-Aware Proxy dans votre projet. La passerelle utilise l'API Identity-Aware Proxy pour authentifier et autoriser le trafic sortant de vos agents vers des destinations externes.

Configurer une limite de gestion pour plusieurs projets

Aperçu

Ce produit ou cette fonctionnalité sont soumis aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Pour utiliser le registre d'agents dans plusieurs projets Google Cloud , configurez une limite de gestion. Un périmètre de gestion regroupe un ou plusieurs projets membres Google Cloud dans un projet de gestion central qui sert de projet de gouvernance. Vous pouvez ainsi découvrir et gouverner les agents IA, les serveurs MCP et les outils dans plusieurs projets.

Vous définissez une limite de gestion dans Resource Manager. Pour obtenir des instructions détaillées, consultez Configurer des limites de gestion dans la documentation Resource Manager.

Pour obtenir une présentation de l'architecture de la façon dont les ressources BoundaryConfig, Boundary et CapabilityConfig fonctionnent ensemble, consultez Limites inter-projets.

Lorsque vous créez une ressource CapabilityConfig avec agent-management, Resource Manager active automatiquement agentregistry.googleapis.com sur le projet de gestion. Après avoir établi votre limite de gestion :

1. Si nécessaire pour les opérations locales dans des projets membres individuels, activez l'API Agent Registry sur ces projets membres.
2. Accordez les rôles et autorisations requis aux utilisateurs et aux comptes de service sur le projet de gestion.

Lorsque vous listez ou recherchez des agents ou des serveurs MCP dans un emplacement du projet de gestion, Agent Registry agrège et renvoie les ressources détectées automatiquement dans cet emplacement à partir de tous les projets membres de la limite, ainsi que toutes les ressources Service enregistrées créées directement dans cet emplacement sur le projet de gestion. Chaque nom de ressource renvoyé conserve l'ID du composant et utilise le projet spécifié dans la requête.

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.

Remarque : Agent Registry et Agent Gateway sont partiellement compatibles avec la fédération d'identité des employés. Si vous rencontrez des erreurs de chargement ou d'autorisation dans la console Google Cloud , accédez au service avec un compte Google standard géré via Cloud Identity ou Google Workspace.

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

• En savoir plus sur les limites interprojets
• Guide de démarrage rapide : enregistrer un agent
• Enregistrer des serveurs MCP
• Enregistrer des compétences
• Rechercher des agents, des outils et des compétences