設定 Gemini Cloud Assist

主控台

1. 前往 Gemini 管理員頁面。

   前往 Gemini 版 Google Cloud

2. 在頁面頂端的專案選擇工具中，選取專案資源。

3. 選取「取得 Gemini Cloud Assist」。

4. 在「Get Gemini Cloud Assist」對話方塊中，執行下列操作：

   1. 選取「必要和建議的 API」專區中的 expand_more 展開箭頭。

   2. 請確認已啟用下列必要 API：Gemini Cloud Assist API 和 Gemini for Google Cloud API。

   3. 在「建議 API」清單中，選取要啟用的 API。

   4. 選用步驟：選取「分享提示和答案，協助 Google 提高 Cloud Assist 的品質」。

   5. 選取「免費啟用 Gemini Cloud Assist」。

5. 按一下 [儲存]。

6. 授予使用 Gemini Cloud Assist 所需的 IAM 角色。

   1. 前往「IAM & Admin」(IAM 與管理) 頁面。

      前往「IAM & Admin」(IAM 與管理)

   2. 在「Principal」欄中，找出您要授予 Gemini Cloud Assist 存取權的主體，然後點選該列中的 edit「Edit principal」。

   3. 在「Edit access」(編輯存取權)窗格中，按一下 add「Add another role」(新增其他角色)。

   4. 在「請選擇角色」中，選取「Gemini Cloud Assist User」。

   5. 按一下「新增其他角色」，然後選取「推薦者檢視者」。

   如果主體想取得未具備存取權的產品相關協助，您可能需要授予他們其他 IAM 角色。如需不同產品的最佳 Gemini Cloud Assist 體驗，請參閱 使用 Gemini Cloud Assist 的 IAM 需求，其中列出可提供最佳 Gemini Cloud Assist 體驗的 IAM 角色。

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. 使用 gcloud services enable 指令啟用 Gemini Cloud Assist API：

   gcloud services enable geminicloudassist.googleapis.com
   

   這項步驟也會啟用 Gemini for Google Cloud API，這是使用 Gemini Cloud Assist 的必要條件。

   如要在其他Google Cloud 專案中啟用 Gemini Cloud Assist API，請新增 --project 參數：

   gcloud services enable geminicloudassist.googleapis.com --project PROJECT_ID
   

   輸出結果會與下列內容相似：

   Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
   Operation finished successfully.
   

3. 在 Google Cloud 專案中授予 IAM 角色。詳情請參閱「授予單一角色」和 gcloud projects add-iam-policy-binding。

   1. 授予 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
      

   2. 針對 roles/recommender.viewer 角色重複執行上述步驟。

   如果主體想取得未具備存取權的產品相關協助，您可能需要授予他們其他 IAM 角色。如需不同產品的最佳 Gemini Cloud Assist 體驗，請參閱 使用 Gemini Cloud Assist 的 IAM 需求，其中列出可提供最佳 Gemini Cloud Assist 體驗的 IAM 角色。

API

這些操作說明會使用 cURL 呼叫 API 方法。

1. 使用 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 欄位中的值，查看作業狀態。

2. 為相關聯的 Google Cloud 專案授予 IAM 角色。

   1. 建立包含下列資訊的 JSON 檔案：

        {
          "options": {
            "requestedPolicyVersion": 3
          }
        }
      

   2. 使用 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 政策。

   3. 將專案的 IAM 政策複製到空白 JSON 檔案，然後在現有內容中新增下列資訊：

        {
          "role": "roles/geminicloudassist.user",
          "members": [
            "PRINCIPAL"
          ]
        },
        {
          "role": "roles/recommender.viewer",
          "members": [
            "PRINCIPAL"
          ]
        }
      

      將 PRINCIPAL 替換為您要授予 Gemini Cloud Assist 存取權的實體 ID。

   4. 使用 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 體驗，請參閱 使用 Gemini Cloud Assist 的 IAM 需求，其中列出可提供最佳 Gemini Cloud Assist 體驗的 IAM 角色。