本頁面說明使用者需要具備哪些 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 角色
如要一般使用 Gemini Cloud Assist,建議您採用下列 IAM 角色:
| IAM 角色 | 附註 |
|---|---|
| Gemini Cloud Assist 使用者 | 這個角色可讓使用者使用 Gemini Cloud Assist,包括叫用代理、對話、建立代理構件,以及共用使用者擁有的構件。 |
| Cloud Asset 檢視者 | 這個角色可讓使用者的代理探索與使用者問題相關的資產拓撲,因為 Cloud Asset Inventory 會管理 Google Cloud 資產和與這些資產相關聯的中繼資料。資產包括 Google Cloud 資源、政策和設定。 |
如要授予這些角色,請按照「為專案設定 Gemini Cloud Assist」中的步驟操作。如需一般操作說明,請參閱「管理專案、資料夾和組織的存取權」。
Gemini Cloud Assist 適用的 IAM 角色
在多數情況下,建議使用 Gemini Cloud Assist 使用者這個 IAM 角色,在某些情況下,您可能需要將這個角色切換為其他 Gemini Cloud Assist 角色。下表列出可用的 Gemini Cloud Assist 角色:
| IAM 角色 | 函式 |
|---|---|
| Gemini Cloud Assist 檢視者 | 這個角色可授予使用者權限,查看代理構件 (例如調查或報告) 和代理設定。相較於 Gemini Cloud Assist 使用者角色,這個角色授予的存取權限較有限。舉例來說,Gemini Cloud Assist 檢視者角色不具備叫用代理或與代理對話的權限。 |
| Gemini Cloud Assist 使用者 | 這個角色可讓使用者使用 Gemini Cloud Assist,包括叫用代理、對話、建立代理構件,以及共用使用者擁有的構件。 |
| Gemini Cloud Assist 編輯者 | 這個角色會授予使用者 Gemini Cloud Assist 的編輯者權限。 除了 Gemini Cloud Assist 使用者角色包含的權限外,編輯者角色還包含刪除對話主題、刪除代理構件,以及更新特定代理設定的權限。 |
| Gemini Cloud Assist 管理員 | 這個角色會授予使用者 Gemini Cloud Assist 的管理權限。除了 Gemini Cloud Assist 編輯者角色包含的權限外,管理員角色還包含可設定 Gemini Cloud Assist 不同政策的權限,例如啟用主動式代理和資料共用、授予代理權限,以及在整個專案共用構件。 |
特定 IAM 權限
下列是 Gemini Cloud Assist 運作時所需的重要 IAM 權限。建立自訂 IAM 角色時,請使用這項資訊。
| IAM 權限 | 函式 |
|---|---|
geminicloudassist.agents.invoke
|
與 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.siteReliabilityEngineerroles/iam.supportUser |
| 在多個領域廣泛部署、更新及探索 Google Cloud 基礎架構 |
roles/iam.infrastructureAdminroles/iam.devOpsroles/logging.viewerroles/monitoring.viewerroles/cloudtrace.userroles/apptopology.viewer |
| 探索、瞭解及排解網路基礎架構問題 |
roles/iam.networkAdminroles/logging.viewerroles/monitoring.viewerroles/cloudtrace.userroles/apptopology.viewer |
| 透過資料處理、轉換和分析管道,與資料互動及分析資料 |
roles/iam.dataScientistroles/logging.viewerroles/monitoring.viewer |
| 部署、更新資料庫及排解相關問題 |
roles/iam.databaseAdminroles/logging.viewerroles/monitoring.viewer |
| 瞭解及分析應用程式的詳細費用 |
roles/cloudhub.operatorroles/monitoring.viewerroles/logging.viewer |
| 瀏覽及查看 Google Cloud 資源、資料夾階層、記錄、安全性設定和重要資源中繼資料。 |
roles/iam.securityAuditor |
| 使用 Gemini Cloud Assist 搭配 Storage Insights 資料集,瞭解 Cloud Storage 用量。 |
roles/bigquery.jobUserroles/bigquery.dataViewerroles/storageinsights.viewer |