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.siteReliabilityEngineerroles/iam.supportUser |
| Implementar, actualizar y explorar la infraestructura de Google Cloud en general en varios dominios |
roles/iam.infrastructureAdminroles/iam.devOpsroles/logging.viewerroles/monitoring.viewerroles/cloudtrace.userroles/apptopology.viewer |
| Explora, comprende y soluciona problemas de tu infraestructura de red |
roles/iam.networkAdminroles/logging.viewerroles/monitoring.viewerroles/cloudtrace.userroles/apptopology.viewer |
| Interactuar con los datos y analizarlos a través de canalizaciones de procesamiento, transformación y análisis de datos |
roles/iam.dataScientistroles/logging.viewerroles/monitoring.viewer |
| Implementar, actualizar y solucionar problemas de bases de datos |
roles/iam.databaseAdminroles/logging.viewerroles/monitoring.viewer |
| Comprende y analiza en detalle los costos de tu aplicación |
roles/cloudhub.operatorroles/monitoring.viewerroles/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.jobUserroles/bigquery.dataViewerroles/storageinsights.viewer |