Funciones y permisos

Los roles y permisos de Identity and Access Management (IAM) te permiten controlar quién puede ver, registrar y administrar agentes, servidores de MCP, herramientas, habilidades independientes, extremos y vinculaciones en el registro de agentes.

Para otorgar roles de IAM del Registro de agentes a usuarios o grupos en tu proyecto de administración o tu proyecto de administración, usa la página de IAM en la consola de Google Cloud o Google Cloud CLI. Para obtener más detalles, consulta Control de acceso con IAM y 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:

Precaución: Otorga los roles de administrador de la API de Agent Registry (roles/agentregistry.admin) o editor de la API de Agent Registry (roles/agentregistry.editor) solo a administradores de confianza que administren el registro. Evita otorgar estos roles directamente a los agentes. Estos roles contienen permisos para crear, borrar y actualizar servicios, incluida la modificación de metadatos críticos del agente y anotaciones de herramientas, como readOnlyHint o destructiveHint. Los cambios maliciosos en los metadatos y las anotaciones pueden causar consecuencias no deseadas y destructivas cuando un orquestador usa la herramienta modificada. Además, un agente con estos permisos puede inscribir de forma explícita un agente externo malicioso en el registro.

Función	Descripción	Purpose
Administrador de la API de Agent Registry (roles/agentregistry.admin)	Tiene acceso total a todos los recursos de Agent Registry, incluidos los agentes, los servidores de MCP, las herramientas, los endpoints, las habilidades independientes, las revisiones de habilidades, las vinculaciones y las políticas de IAM de habilidades.	Registra y administra agentes, servidores de MCP, herramientas y endpoints. Crear, actualizar y borrar habilidades independientes y revisiones de habilidades. Crear y administrar vinculaciones y políticas de IAM de habilidades
Editor de la API de Agent Registry (roles/agentregistry.editor)	Tiene acceso de edición a los recursos de Agent Registry, incluidos los agentes, los servidores de MCP, las herramientas, los endpoints, las habilidades independientes y las revisiones de habilidades.	Registra y administra agentes y servidores de MCP. Actualizar las definiciones y los extremos de las herramientas Crear, actualizar y borrar habilidades independientes y revisiones de habilidades.
Visualizador de la API de Agent Registry (roles/agentregistry.viewer)	Acceso de solo lectura para ver y buscar agentes, servidores de MCP, herramientas, habilidades independientes, revisiones de habilidades, publicadores, endpoints y vinculaciones.	Descubrir agentes, servidores de MCP y herramientas disponibles Consulta las habilidades de A2A, las habilidades independientes, las revisiones de habilidades, los publicadores, los extremos y las vinculaciones para la integración.
Usuario del registro de agentes (roles/agentregistry.user)	Acceso de solo lectura a los recursos de Agent Registry, además de acceso para crear, actualizar y borrar habilidades independientes y revisiones de habilidades.	Crear, actualizar y borrar habilidades independientes y revisiones de habilidades sin acceso de edición a agentes, servidores de MCP o endpoints Mantén el control de versión para las revisiones de habilidades y administra de forma centralizada los estados activos de las habilidades.

Permisos de Agent Registry

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

Administrador de la API de Agent Registry Editor de la API de Agent Registry Visualizador de la API de Agent Registry Usuario de Agent Registry Borrar todo

Administrador de la API de Agent Registry ^Beta (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.publishers.get agentregistry.publishers.list agentregistry.services.create agentregistry.services.delete agentregistry.services.get agentregistry.services.list agentregistry.services.update agentregistry.skillRevisions.create agentregistry.skillRevisions.delete agentregistry.skillRevisions.get agentregistry.skillRevisions.list agentregistry.skills.create agentregistry.skills.delete agentregistry.skills.get agentregistry.skills.getIamPolicy agentregistry.skills.list agentregistry.skills.search agentregistry.skills.setIamPolicy agentregistry.skills.update
Editor de la API de Agent Registry ^Beta (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.publishers.* agentregistry.publishers.get agentregistry.publishers.list agentregistry.services.* agentregistry.services.create agentregistry.services.delete agentregistry.services.get agentregistry.services.list agentregistry.services.update agentregistry.skillRevisions.* agentregistry.skillRevisions.create agentregistry.skillRevisions.delete agentregistry.skillRevisions.get agentregistry.skillRevisions.list agentregistry.skills.create agentregistry.skills.delete agentregistry.skills.get agentregistry.skills.list agentregistry.skills.search agentregistry.skills.update
Visualizador de la API de Agent Registry ^Beta (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.publishers.* agentregistry.publishers.get agentregistry.publishers.list agentregistry.services.get agentregistry.services.list agentregistry.skillRevisions.get agentregistry.skillRevisions.list agentregistry.skills.get agentregistry.skills.list agentregistry.skills.search
Usuario de Agent Registry ^Beta (roles/agentregistry.user) Crea, actualiza y borra habilidades y revisiones de habilidades.	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.publishers.* agentregistry.publishers.get agentregistry.publishers.list agentregistry.services.get agentregistry.services.list agentregistry.skillRevisions.* agentregistry.skillRevisions.create agentregistry.skillRevisions.delete agentregistry.skillRevisions.get agentregistry.skillRevisions.list agentregistry.skills.create agentregistry.skills.delete agentregistry.skills.get agentregistry.skills.list agentregistry.skills.search agentregistry.skills.update

Para obtener más información sobre los permisos de IAM, consulta Encuentra los roles predefinidos adecuados y Índice de roles y permisos de IAM.

Roles para los límites de administración entre proyectos

Cuando configuras un límite de administración para tus componentes de agentes en el Registro de agentes, debes otorgar roles de IAM a los usuarios o servicios en los siguientes niveles:

• Proyecto de administración: Otorga roles de Agent Registry en el proyecto de administración a los usuarios o servicios que descubren y administran agentes en todo el límite. Los usuarios con acceso de visualizador en el proyecto de administración pueden descubrir y buscar agentes y servidores de MCP de todos los proyectos miembros en todos los límites adjuntos a ese proyecto de administración sin necesidad de que se les otorguen permisos de visualizador explícitos en cada proyecto miembro individual. Si un equipo no debe ver los recursos de otros límites, asigna ese límite a un proyecto de administración y recursos de CapabilityConfig independiente.
• Proyectos de miembros: Otorga roles de registro de agentes en proyectos de miembros específicos a los desarrolladores que compilan, registran o mantienen agentes y herramientas dentro de esos proyectos específicos.
• Configuración de límites: La creación y administración de recursos de configuración de límites requiere roles administrativos en la carpeta o la organización que los contiene. Para obtener más información, consulta los roles requeridos en Configura límites de administración en la documentación de Resource Manager.

Restringe los registros locales en los proyectos miembros

Debido a que los recursos Service y Binding registrados de forma manual que se crean en un proyecto miembro no se acumulan en el proyecto de administración, los administradores de seguridad pueden aplicar el registro centralizado en el proyecto de administración de cualquiera de las siguientes maneras:

• Bloquea agentregistry.googleapis.com en los proyectos miembros: Cuando los desarrolladores no necesitan consultar el Registro de agentes directamente en un proyecto miembro, aplica la constraints/gcp.restrictServiceUsage restricción de la política de la organización en la carpeta o la organización superior para denegar agentregistry.googleapis.com y anular la política en el proyecto de administración. Bloquear agentregistry.googleapis.com en los proyectos miembros no afecta el descubrimiento automático de las cargas de trabajo del entorno de ejecución de los proyectos miembros en el proyecto de administración.

• Permite el descubrimiento de solo lectura en los proyectos miembros y deniega las escrituras locales: para mantener agentregistry.googleapis.com habilitado en los proyectos miembros para el descubrimiento local de solo lectura, mientras se requiere que todos los recursos Service y Binding se registren en el proyecto de administración, otorga a los desarrolladores el rol de visualizador de la API de Agent Registry (roles/agentregistry.viewer) en el proyecto miembro y adjunta una política de denegación de IAM que deniegue los siguientes permisos de escritura en los proyectos miembros:

  • agentregistry.googleapis.com/services.create
  • agentregistry.googleapis.com/services.update
  • agentregistry.googleapis.com/services.delete
  • agentregistry.googleapis.com/bindings.create
  • agentregistry.googleapis.com/bindings.update
  • agentregistry.googleapis.com/bindings.delete

Control de acceso para recursos registrados

Los roles de Agent Registry rigen quién puede administrar y descubrir recursos en el registro. Para controlar qué agentes pueden comunicarse con los servicios, los extremos y los servidores de MCP registrados a través de Agent Gateway, usa las políticas de salida de Identity-Aware Proxy (IAP):

• Permisos de acceso de salida: Para autorizar a un agente a enrutar el tráfico a un agente registrado, un servidor de MCP o un extremo, otorga el rol de IAP-secured Egressor (roles/iap.egressor) al principal del agente en el recurso de destino.
• Permisos de administración de políticas: Para configurar las políticas de IAM de la Web de IAP en los recursos registrados, debes obtener el rol de Administrador de políticas de IAP (roles/iap.admin) en el proyecto de administración que aloja el registro.

Para obtener instrucciones detalladas sobre cómo configurar las políticas de salida de IAP, consulta Configura las políticas de agentes de IAM.