Funciones y permisos

Agent Registry proporciona los siguientes roles de Identity and Access Management (IAM):

  • Administrador de la API de Agent Registry (roles/agentregistry.admin): Realiza todas las acciones, incluido el registro manual de agentes y la actualización de metadatos.
  • Editor de la API de Agent Registry (roles/agentregistry.editor): Acceso de edición a los recursos de Agent Registry
  • Visualizador de la API de Agent Registry (roles/agentregistry.viewer): Visualiza agentes, herramientas y sus atributos.

Otorga los roles de IAM adecuados del registro de agentes a los usuarios o grupos que administrarán o verán los agentes en el registro. Para otorgar roles, puedes usar la página de IAM en la consola de Google Cloud o en Google Cloud CLI. Para obtener instrucciones detalladas, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Roles de Agent Registry

En la siguiente tabla, se describen los roles de IAM del Registro de agentes y sus responsabilidades típicas:

Función

Descripción

Purpose

Administrador de la API de Agent Registry

Realizar todas las acciones, incluido el registro manual de agentes y la actualización de metadatos

  • Registrar y administrar agentes y servidores de MCP
  • Actualiza las definiciones y los extremos de las herramientas.

Editor de la API de Agent Registry

Tiene acceso de edición a los recursos de Agent Registry.

  • Registrar y administrar agentes y servidores de MCP
  • Actualiza las definiciones y los extremos de las herramientas.

Visualizador de la API de Agent Registry

Consulta los agentes, las herramientas y sus atributos.

  • Descubre los agentes y servidores de MCP disponibles.
  • Visualiza las habilidades y los extremos para la integración.

Permisos de Agent Registry

En la siguiente tabla, se enumeran los permisos que tiene cada rol de IAM del Registro de agentes:

(roles/agentregistry.admin)

Tiene acceso total a los recursos de la API de 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)

Tiene acceso de edición a los recursos de la API de 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)

Tiene acceso de solo lectura a los recursos de la API de 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

Para obtener más información sobre los permisos de IAM, consulta Cómo encontrar los roles predefinidos adecuados y el índice de roles y permisos de IAM.