Requisitos de IAM para usar Gemini Cloud Assist

En esta página, se analizan los roles de Identity and Access Management que los usuarios necesitan para usar Gemini Cloud Assist de forma correcta. Para obtener información sobre cómo configurar Gemini Cloud Assist, consulta Configura Gemini Cloud Assist.

Descripción general

Para responder preguntas y solicitudes sobre tus recursos de Google Cloud , Gemini Cloud Assist necesita los permisos de IAM adecuados para esos recursos. Gemini Cloud Assist tiene los mismos permisos que el usuario que consulta Gemini Cloud Assist, por lo que, en muchos casos, ya se otorgaron los permisos de IAM necesarios.

Roles de IAM para usar Gemini Cloud Assist

Se recomiendan los siguientes roles de IAM para el uso general de Gemini Cloud Assist:

Rol de IAM Notas
Usuario de Gemini Cloud Assist Este rol otorga a los usuarios permiso para usar Gemini Cloud Assist, lo que incluye invocar agentes, chatear, crear artefactos de agentes y compartir artefactos que pertenecen al usuario.
Visualizador de recursos de Cloud Este rol permite que el agente del usuario descubra la topología de los recursos pertinentes para la pregunta del usuario, ya que Cloud Asset Inventory administra los recursos de Google Cloud y los metadatos asociados a esos recursos. Los recursos incluyen tus recursos, políticas y parámetros de configuración de Google Cloud .

Para otorgar estos roles, sigue los pasos que se indican en Configura Gemini Cloud Assist para un proyecto. Para obtener instrucciones generales, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Roles de IAM disponibles para Gemini Cloud Assist

En la mayoría de los casos, el rol de IAM recomendado para usar Gemini Cloud Assist es Usuario de Gemini Cloud Assist. En algunos casos, es posible que quieras cambiar este rol por otro de Gemini Cloud Assist. En la siguiente tabla, se enumeran los diferentes roles de Gemini Cloud Assist que puedes usar:

Rol de IAM Función
Visualizador de Gemini Cloud Assist Este rol otorga a los usuarios permiso para ver los artefactos del agente, como investigaciones o informes, y ver las configuraciones del agente. Este rol otorga un acceso más limitado en comparación con el rol de usuario de Gemini Cloud Assist. Por ejemplo, el rol de visualizador de Gemini Cloud Assist no otorga permiso para invocar al agente ni chatear con él.
Usuario de Gemini Cloud Assist Este rol otorga a los usuarios permiso para usar Gemini Cloud Assist, lo que incluye invocar agentes, chatear, crear artefactos de agentes y compartir artefactos que pertenecen al usuario.
Editor de Gemini Cloud Assist Este rol otorga a los usuarios permisos de editor para Gemini Cloud Assist. Además de los permisos que contiene el rol de usuario de Gemini Cloud Assist, el rol de editor contiene permisos para borrar temas de chat, borrar artefactos de agentes y actualizar parámetros de configuración específicos de los agentes.
Administrador de Gemini Cloud Assist Este rol otorga a los usuarios permisos de administrador para Gemini Cloud Assist. Además de los permisos que contiene el rol de editor de Gemini Cloud Assist, el rol de administrador contiene permisos que te permiten configurar diferentes políticas de Gemini Cloud Assist, como habilitar agentes proactivos y el uso compartido de datos, otorgar permisos en agentes y compartir artefactos en todo el proyecto.

Permisos de IAM específicos

Los siguientes son permisos de IAM específicos que son importantes para el funcionamiento de Gemini Cloud Assist. Usa esta información cuando crees roles de IAM personalizados.

Permisos de IAM Función
geminicloudassist.agents.invoke Enviar y recibir mensajes a los agentes de Gemini Cloud Assist
cloudaicompanion.topics.create Inicia un chat con Gemini Cloud Assist.
cloudaicompanion.geminiGcpEnablementSettings.update Configurar los parámetros de administrador de Gemini Cloud Assist
mcp.tools.call Envío y recepción de mensajes a agentes de Gemini Cloud Assist a través de MCP

Permisos necesarios para el chat

El panel de chat de Gemini Cloud Assist usa un recurso de backend llamado tema. Cuando inicias un chat, Gemini Cloud Assist crea un recurso de tema y te otorga el rol roles/cloudaicompanion.topicAdmin para ese tema, que incluye el permiso cloudaicompanion.topics.update. Este comportamiento significa que solo el usuario que creó el tema puede ver y actualizar un chat.

Si tu organización tiene una restricción personalizada que impide que Gemini Cloud Assist otorgue roles/cloudaicompanion.topicAdmin a los usuarios, tu intento de iniciar una sesión de chat fallará. Para solucionar el problema, pídele a tu administrador que actualice las restricciones personalizadas de la organización para permitir que se otorguen roles específicos.

Recomendaciones de roles de IAM para diferentes casos de uso

Además del acceso otorgado desde los roles de IAM para usar Gemini Cloud Assist, las tareas que se realizan a través de Gemini Cloud Assist requieren acceso a los recursos deGoogle Cloud que son relevantes para esa tarea. Por ejemplo:

  • Si usas agentes para comprender el estado de las aplicaciones de GKE, los permisos de IAM para GKE y sus recursos asociados son los más importantes.

  • Si usas agentes para implementar trabajos de procesamiento de datos, los permisos de IAM para Dataflow, Managed Service para Apache Spark o BigQuery podrían ser los más importantes.

Los permisos de IAM necesarios dependen del dominio específico en el que se encuentran tus tareas. A su vez, los roles de IAM adecuados que contienen estos permisos varían según el caso de uso. Los siguientes roles de IAM de función de trabajo proporcionan un buen punto de partida si no estás seguro de qué roles deben tener los usuarios o las identidades de los agentes.

Tarea Roles relevantes
Solucionar problemas y garantizar la confiabilidad y escalabilidad de la infraestructura de Google Cloud en varios dominios, de forma proactiva e interactiva
  • roles/iam.siteReliabilityEngineer
  • roles/iam.supportUser
  • Implementar, actualizar y explorar la infraestructura de Google Cloud en general en varios dominios
  • roles/iam.infrastructureAdmin
  • roles/iam.devOps
  • roles/logging.viewer
  • roles/monitoring.viewer
  • roles/cloudtrace.user
  • roles/apptopology.viewer
  • Explora, comprende y soluciona problemas de tu infraestructura de red
  • roles/iam.networkAdmin
  • roles/logging.viewer
  • roles/monitoring.viewer
  • roles/cloudtrace.user
  • roles/apptopology.viewer
  • Interactuar con los datos y analizarlos a través de canalizaciones de procesamiento, transformación y análisis de datos
  • roles/iam.dataScientist
  • roles/logging.viewer
  • roles/monitoring.viewer
  • Implementar, actualizar y solucionar problemas de bases de datos
  • roles/iam.databaseAdmin
  • roles/logging.viewer
  • roles/monitoring.viewer
  • Comprende y analiza en detalle los costos de tu aplicación
  • roles/cloudhub.operator
  • roles/monitoring.viewer
  • roles/logging.viewer
  • Explorar y ver los recursos de Google Cloud , la jerarquía de carpetas, los registros, la configuración de seguridad y los metadatos de los recursos clave
  • roles/iam.securityAuditor
  • Usar Gemini Cloud Assist con conjuntos de datos de Storage Insights para comprender tu uso de Cloud Storage.
  • roles/bigquery.jobUser
  • roles/bigquery.dataViewer
  • roles/storageinsights.viewer