Gemini Cloud Assist 提供情境式 AI 指引,協助您設計、操作及最佳化雲端應用程式和基礎架構。管理員必須先完成專案或資料夾的初始設定,團隊成員才能使用這些功能。
為專案設定 Gemini Cloud Assist
下列步驟詳細說明如何為專案設定 Gemini Cloud Assist。
控制台
前往「Gemini 管理」頁面。
從頁面頂端的專案挑選器中,選取專案資源。
選取「啟用 Gemini Cloud Assist」。
在「Get Gemini Cloud Assist」(取得 Gemini Cloud Assist) 對話方塊中,執行下列操作:
選取「Required & recommended APIs」(必要和建議的 API) 專區中的 展開箭頭。
在「Recommended APIs」(建議的 API) 清單中,選取要啟用的其他 API,提升 Gemini Cloud Assist 的效能。
選用:選取「Help Google improve Cloud Assist by sharing your prompts and answers」(分享提示詞和答案,協助 Google 改良 Cloud Assist)。
選取「免付費啟用 Gemini Cloud Assist」。
按一下「儲存」。
授予使用 Gemini Cloud Assist 所需的 IAM 角色。
前往「IAM & Admin」(IAM 與管理) 頁面。
在「Principal」(主體) 欄中,找出要授予 Gemini Cloud Assist 存取權的主體,然後按一下該列中的 「Edit principal」(編輯主體)。
在「Edit access」(編輯權限) 窗格中,按一下 「Add another role」(新增其他角色)。
在「選取角色」中,選取「Gemini Cloud Assist 使用者」。
按一下「新增其他角色」,然後選取「Cloud 資產檢視者」。
如果主體想取得目前無法存取的產品相關協助,您可能需要授予其他 IAM 角色,方法是按一下「Add another role」(新增其他角色),然後選取其他角色。請參閱「使用 Gemini Cloud Assist 的 IAM 需求」,瞭解哪些 IAM 角色可為不同產品提供最佳 Gemini Cloud Assist 體驗。
(選用) 調整專案設定。
gcloud
-
在 Google Cloud 控制台啟用 Cloud Shell。
使用
gcloud services enable指令啟用 Gemini Cloud Assist API:gcloud services enable geminicloudassist.googleapis.com這個步驟也會啟用 Gemini for Google Cloud API,此 API 也是使用 Gemini Cloud Assist 的必要條件。
如要在其他Google Cloud 專案中啟用 Gemini Cloud Assist API,請新增
--project參數:gcloud services enable geminicloudassist.googleapis.com --project PROJECT_ID將
PROJECT_ID替換為要啟用 Gemini Cloud Assist 的專案 ID。輸出結果會與下列內容相似:
Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete... Operation finished successfully.
使用
gcloud services enable指令啟用其他必要 API,就像啟用 Gemini Cloud Assist API 一樣:gcloud services enable cloudasset.googleapis.com designcenter.googleapis.com appoptimize.googleapis.com apphub.googleapis.com --project PROJECT_ID(選用) 按照啟用 Gemini Cloud Assist API 的方式,使用
gcloud services enable指令啟用建議的 API。在 Google Cloud 專案中授予 IAM 角色。詳情請參閱「授予單一角色」和「
gcloud projects add-iam-policy-binding」。授予
roles/geminicloudassist.user角色:gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL --role=roles/geminicloudassist.user
更改下列內容:
PROJECT_ID:Google Cloud 專案的 ID,例如1234567890。PRINCIPAL:主體的 ID,例如user:cloudysanfrancisco@gmail.com。
輸出內容是政策繫結清單,包含下列項目:
- members: - user:PRINCIPAL role: roles/geminicloudassist.user對
roles/cloudasset.viewer角色重複執行上述步驟。如果主體想取得目前無法存取的產品相關協助,您可能需要授予額外的 IAM 角色。請參閱「使用 Gemini Cloud Assist 的 IAM 需求」,瞭解哪些 IAM 角色可為不同產品提供最佳 Gemini Cloud Assist 體驗。
(選用) 調整專案設定。
API
這些操作說明使用 cURL 呼叫 API 方法。
使用
services.enable方法啟用 Gemini Cloud Assist API:curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/geminicloudassist.googleapis.com:enable"
將
PROJECT_ID替換為要啟用 Gemini Cloud Assist 的專案 ID。如果指令執行成功,會傳回
long-running operation,其中包含name欄位。您可以使用name欄位中的值檢查作業狀態。使用
services.enable方法啟用下列其他必要 API,就像啟用 Gemini Cloud Assist API 一樣:cloudasset.googleapis.comdesigncenter.googleapis.comappoptimize.googleapis.comapphub.googleapis.com
(選用) 按照啟用 Gemini Cloud Assist API 的方式,使用
services.enable方法啟用Recommender API。授予相關聯 Google Cloud 專案的 IAM 角色。
建立含有以下資訊的 JSON 檔案:
{ "options": { "requestedPolicyVersion": 3 } }使用
projects.getIamPolicy方法擷取專案現有的 IAM 政策:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:getIamPolicy"更改下列內容:
JSON_FILE_NAME:上一個步驟中建立的 JSON 檔案路徑。PROJECT_ID:專案 ID。
如果成功,回應會傳回專案的 IAM 政策。
將專案的 IAM 政策複製到空白 JSON 檔案,並在現有內容中新增下列資訊:
{ "role": "roles/geminicloudassist.user", "members": [ "PRINCIPAL" ] }, { "role": "roles/cloudasset.viewer", "members": [ "PRINCIPAL" ] }將
PRINCIPAL替換為要授予 Gemini Cloud Assist 存取權的主體 ID。使用
projects.setIamPolicy方法,將更新後的 IAM 政策套用至專案:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:setIamPolicy"更改下列內容:
JSON_FILE_NAME:上一個步驟中建立的 JSON 檔案路徑。PROJECT_ID:專案 ID。
如果成功,回應會傳回專案更新後的 IAM 政策。
如果主體想取得目前無法存取的產品相關協助,您可能需要授予額外的 IAM 角色。請參閱「使用 Gemini Cloud Assist 的 IAM 需求」,瞭解哪些 IAM 角色可為不同產品提供最佳 Gemini Cloud Assist 體驗。
(選用) 調整專案設定。
為資料夾設定 Gemini Cloud Assist
下列步驟詳細說明如何使用 Google Cloud 控制台,為資料夾設定 Gemini Cloud Assist。您無法使用 Google Cloud CLI 或 API 為資料夾設定 Gemini Cloud Assist。
啟用必要和建議的 API。
前往「Gemini 管理」頁面。
從頁面頂端的專案挑選器,選取資料夾資源。
選取「啟用 Cloud Assist API」。
「Enable API for existing projects within folder」(為資料夾中的現有專案啟用 API) 對話方塊隨即顯示。
在「Enable API for existing projects within a folder」(為資料夾中的現有專案啟用 API) 對話方塊中,選取「Required & recommended APIs」(必要和建議的 API) 區段中的 展開箭頭。
在「Recommended APIs」(建議的 API) 清單中,選取要啟用的選用 API。
選用:選取「Help Google improve Cloud Assist by sharing your prompts and answers」(分享提示詞和答案,協助 Google 改良 Cloud Assist)。
選取「免付費啟用 Gemini Cloud Assist」。
這個步驟會為資料夾中的所有專案,啟用必要和所選的建議 API。如要為資料夾中的某些專案設定例外狀況,可以對這些專案設定限制資源服務用量組織政策限制,禁止啟用 API。詳情請參閱「限制資源用量」。
授予下列 IAM 角色,或建立自訂角色,並在資料夾中授予同等權限:
- Gemini Cloud Assist 使用者
- 雲端資產檢視者
如果主體想請 Gemini 協助調查目前無法存取的產品,您可能需要授予其他 IAM 角色。請參閱「使用 Gemini Cloud Assist 的 IAM 需求」,瞭解哪些 IAM 角色可為不同產品提供最佳 Gemini Cloud Assist 體驗。
如果資料夾隸屬於使用自訂限制的組織,請參閱對話所需權限,確保 Gemini Cloud Assist 對話功能未遭封鎖。
如果搭配應用程式使用 Gemini Cloud Assist,則必須在資料夾層級啟用應用程式管理功能。這個步驟會建立管理專案,您必須將帳單帳戶連結至該專案。
返回「Gemini 管理」頁面。
選取「啟用應用程式管理功能」。
「IAM & Admin」(IAM 與管理) 設定頁面隨即顯示。
在頁面的「應用程式啟用」部分,選取「啟用」。
「啟用這個資料夾的應用程式 API」對話方塊隨即顯示。
選取「Enable」(啟用)。
狀態列會顯示 API 啟用進度。API 啟用完成後,「IAM & Admin」(IAM 與管理) 設定頁面會重新整理。
選取「管理帳單」。
「已連結帳戶」頁面隨即顯示。
從清單中選取帳單帳戶,然後選取「設定帳戶」。
授予 IAM 角色:授予您在步驟 2 中授予資料夾的角色,或建立自訂角色,並授予與上一步建立的管理專案相同的權限。
找出資料夾的管理專案:
返回「Gemini 管理」頁面。
從頁面頂端的專案挑選器,選取資料夾資源。
選取「管理 Gemini Cloud Assist 設定」。
「管理 Gemini Cloud Assist」對話方塊隨即顯示。
請記下「管理專案」。
(選用) 調整資料夾中專案的設定。
後續步驟
- 瞭解 Gemini Cloud Assist 定價。
- 瞭解如何在 Google Cloud 控制台使用 Cloud Assist 面板。
- 瞭解如何調整 Gemini Cloud Assist 的其他設定。