使用 Gemini Cloud Assist 的 IAM 要求

本页介绍了用户需要具备的 Identity and Access Management 角色,才能成功使用 Gemini Cloud Assist。如需了解如何设置 Gemini Cloud Assist,请参阅设置 Gemini Cloud Assist。

概览

为了支持与您的 Google Cloud 资源相关的问题和请求,Gemini Cloud Assist 需要获得这些资源的适当 IAM 权限。Gemini Cloud Assist 具有与查询 Gemini Cloud Assist 的用户相同的权限,因此在许多情况下,系统已授予必要的 IAM 权限。

使用 Gemini Cloud Assist 的 IAM 角色

建议将以下 IAM 角色用于 Gemini Cloud Assist 的一般用途:

IAM 角色 备注
Gemini Cloud Assist User 此角色可授予用户使用 Gemini Cloud Assist 的权限,包括调用代理、聊天、创建代理工件以及共享用户拥有的工件。
Cloud Asset Viewer 此角色允许用户的代理发现与用户问题相关的资产拓扑,因为 Cloud Asset Inventory 管理 Google Cloud 资产和与这些资产关联的元数据。资产包括您的 Google Cloud 资源、政策和配置。

如需授予这些角色,请按照为项目设置 Gemini Cloud Assist 中的步骤操作。如需查看一般说明,请参阅管理对项目、文件夹和组织的访问权限。

适用于 Gemini Cloud Assist 的 IAM 角色

在大多数情况下,建议使用 Gemini Cloud Assist User IAM 角色来使用 Gemini Cloud Assist。在某些情况下,您可能需要将此角色切换为其他 Gemini Cloud Assist 角色。下表列出了您可以使用的不同 Gemini Cloud Assist 角色:

IAM 角色 函数
Gemini Cloud Assist Viewer 此角色可授予用户查看代理工件(例如调查或报告)以及查看代理配置的权限。与 Gemini Cloud Assist User 角色相比,此角色授予的访问权限更有限;例如,Gemini Cloud Assist Viewer 角色不授予调用代理或与代理对话的权限。
Gemini Cloud Assist User 此角色可授予用户使用 Gemini Cloud Assist 的权限,包括调用代理、聊天、创建代理工件以及共享用户拥有的工件。
Gemini Cloud Assist Editor 此角色可授予用户对 Gemini Cloud Assist 的编辑者权限。 除了 Gemini Cloud Assist User 角色中包含的权限之外,编辑者角色还包含删除对话主题、删除代理工件和更新特定代理配置的权限。
Gemini Cloud Assist Admin 此角色可授予用户对 Gemini Cloud Assist 的管理员权限。除了 Gemini Cloud Assist Editor 角色中包含的权限之外,管理员角色还包含可让您配置 Gemini Cloud Assist 的不同政策(例如启用主动代理和数据共享)、授予代理权限以及在整个项目中共享工件的权限。

特定 IAM 权限

以下是对于 Gemini Cloud Assist 的正常运行至关重要的特定 IAM 权限。创建自定义 IAM 角色时,请使用此信息。

IAM 权限 函数
geminicloudassist.agents.invoke 向 Gemini Cloud Assist 代理发送消息以及接收来自 Gemini Cloud Assist 代理的消息。
cloudaicompanion.topics.create 发起与 Gemini Cloud Assist 的对话。
cloudaicompanion.geminiGcpEnablementSettings.update 为 Gemini Cloud Assist 配置管理员设置。
mcp.tools.call 通过 MCP 向 Gemini Cloud Assist 智能体发送消息以及从中接收消息。

聊天所需的权限

Gemini Cloud Assist 对话面板使用名为主题的后端资源。当您发起对话时,Gemini Cloud Assist 会创建一个主题资源,并为您授予该主题的 roles/cloudaicompanion.topicAdmin 角色,其中包括 cloudaicompanion.topics.update 权限。这意味着,只有创建主题的用户才能查看和更新对话。

如果贵组织有自定义限制条件,导致 Gemini Cloud Assist 无法向用户授予 roles/cloudaicompanion.topicAdmin,则您尝试启动聊天会话的操作会失败。如需解决此问题,请让您的管理员更新组织的自定义限制条件,以允许授予特定角色。

针对不同应用场景的 IAM 角色建议

除了通过使用 Gemini Cloud Assist 的 IAM 角色授予的访问权限之外,通过 Gemini Cloud Assist 执行的任务还需要访问Google Cloud 与该任务相关的资源。例如:

  • 如果您使用代理来了解 GKE 应用的运行状况,那么 GKE 及其关联资源的 IAM 权限最为关键。

  • 如果您使用智能体部署数据处理作业,那么 Dataflow、Managed Service for Apache Spark 或 BigQuery 的 IAM 权限可能最为关键。

必要的 IAM 权限取决于任务所在的特定网域。反过来,包含这些权限的适当 IAM 角色因应用场景而异。如果您不确定用户或代理身份应具有哪些角色,以下 IAM 职务角色是一个很好的起点。

任务 相关角色
主动和交互式地排查问题,并确保多个网域中 Google Cloud 基础设施的可靠性和可伸缩性
  • roles/iam.siteReliabilityEngineer
  • roles/iam.supportUser
  • 在多个领域广泛部署、更新和探索 Google Cloud 基础设施
  • roles/iam.infrastructureAdmin
  • roles/iam.devOps
  • roles/logging.viewer
  • roles/monitoring.viewer
  • roles/cloudtrace.user
  • roles/apptopology.viewer
  • 探索、了解网络基础设施并排查其问题
  • roles/iam.networkAdmin
  • roles/logging.viewer
  • roles/monitoring.viewer
  • roles/cloudtrace.user
  • roles/apptopology.viewer
  • 通过数据处理、转换和分析流水线与数据交互并分析数据
  • roles/iam.dataScientist
  • roles/logging.viewer
  • roles/monitoring.viewer
  • 部署、更新数据库并排查数据库问题
  • roles/iam.databaseAdmin
  • roles/logging.viewer
  • roles/monitoring.viewer
  • 详细了解和分析应用的费用
  • roles/cloudhub.operator
  • roles/monitoring.viewer
  • roles/logging.viewer
  • 浏览和查看 Google Cloud 资源、文件夹层次结构、日志、安全配置和关键资源元数据。
  • roles/iam.securityAuditor
  • 将 Gemini Cloud Assist 与存储空间分析数据集搭配使用,以了解您的 Cloud Storage 用量。
  • roles/bigquery.jobUser
  • roles/bigquery.dataViewer
  • roles/storageinsights.viewer