Rôles et autorisations

Agent Registry fournit les rôles IAM (Identity and Access Management) suivants :

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

Accordez les rôles IAM Agent Registry appropriés aux utilisateurs ou aux groupes qui gèrent ou affichent les agents dans le registre. Pour accorder des rôles, vous pouvez utiliser la page IAM de la Google Cloud console ou Google Cloud CLI. Pour obtenir des instructions détaillées, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Rôles Agent Registry

Le tableau suivant décrit les rôles IAM Agent Registry et leurs responsabilités habituelles :

Rôle

Description

Purpose

Administrateur de l'API Agent Registry

Effectue toutes les actions, y compris l'enregistrement manuel des agents et la mise à jour des métadonnées.

  • Enregistre et gère les agents et les serveurs MCP.
  • Met à jour les définitions et les points de terminaison des outils.

Éditeur de l'API Agent Registry

Modifie l'accès aux ressources Agent Registry.

  • Enregistre et gère les agents et les serveurs MCP.
  • Met à jour les définitions et les points de terminaison des outils.

Lecteur de l'API Agent Registry

Affiche les agents, les outils et leurs attributs.

  • Découvre les agents et les serveurs MCP disponibles.
  • Affiche les compétences et les points de terminaison pour l'intégration.

Autorisations Agent Registry

Le tableau suivant répertorie les autorisations dont dispose chaque rôle IAM Agent Registry :

(roles/agentregistry.admin)

Accès complet aux ressources de l'API Agent Registry.

agentregistry.*

  • agentregistry.agents.get
  • agentregistry.agents.list
  • agentregistry.agents.search
  • agentregistry.bindings.create
  • agentregistry.bindings.delete
  • agentregistry.bindings.fetchAvailable
  • agentregistry.bindings.get
  • agentregistry.bindings.list
  • agentregistry.bindings.update
  • agentregistry.endpoints.get
  • agentregistry.endpoints.list
  • agentregistry.locations.get
  • agentregistry.locations.list
  • agentregistry.mcpServers.get
  • agentregistry.mcpServers.list
  • agentregistry.mcpServers.search
  • agentregistry.operations.cancel
  • agentregistry.operations.delete
  • agentregistry.operations.get
  • agentregistry.operations.list
  • agentregistry.services.create
  • agentregistry.services.delete
  • agentregistry.services.get
  • agentregistry.services.list
  • agentregistry.services.update

(roles/agentregistry.editor)

Accès en modification aux ressources de l'API Agent Registry.

agentregistry.agents.*

  • agentregistry.agents.get
  • agentregistry.agents.list
  • agentregistry.agents.search

agentregistry.bindings.fetchAvailable

agentregistry.bindings.get

agentregistry.bindings.list

agentregistry.endpoints.*

  • agentregistry.endpoints.get
  • agentregistry.endpoints.list

agentregistry.locations.*

  • agentregistry.locations.get
  • agentregistry.locations.list

agentregistry.mcpServers.*

  • agentregistry.mcpServers.get
  • agentregistry.mcpServers.list
  • agentregistry.mcpServers.search

agentregistry.operations.*

  • agentregistry.operations.cancel
  • agentregistry.operations.delete
  • agentregistry.operations.get
  • agentregistry.operations.list

agentregistry.services.*

  • agentregistry.services.create
  • agentregistry.services.delete
  • agentregistry.services.get
  • agentregistry.services.list
  • agentregistry.services.update

(roles/agentregistry.viewer)

Accès en lecture seule aux ressources de l'API Agent Registry.

agentregistry.agents.*

  • agentregistry.agents.get
  • agentregistry.agents.list
  • agentregistry.agents.search

agentregistry.bindings.fetchAvailable

agentregistry.bindings.get

agentregistry.bindings.list

agentregistry.endpoints.*

  • agentregistry.endpoints.get
  • agentregistry.endpoints.list

agentregistry.locations.*

  • agentregistry.locations.get
  • agentregistry.locations.list

agentregistry.mcpServers.*

  • agentregistry.mcpServers.get
  • agentregistry.mcpServers.list
  • agentregistry.mcpServers.search

agentregistry.operations.get

agentregistry.operations.list

agentregistry.services.get

agentregistry.services.list

Pour en savoir plus sur les autorisations IAM, consultez la page Rechercher les rôles prédéfinis appropriés et l'index des rôles et autorisations IAM.