設定 Gemini Cloud Assist

如要使用 Gemini Cloud Assist，管理員必須先完成本文所述的設定步驟。您可以為專案或資料夾設定 Gemini Cloud Assist。

為專案設定 Gemini Cloud Assist

下列步驟詳細說明如何為專案設定 Gemini Cloud Assist。

控制台

  1. 前往「Gemini 管理」頁面。

    前往 Gemini 版 Google Cloud

  2. 在頁面頂端的專案挑選器中，選取專案資源。

  3. 選取「啟用 Gemini Cloud Assist」。

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

    1. 選取「必要和建議的 API」部分中的展開箭頭。

    2. 在「建議的 API」清單中，選取要啟用以提升 Gemini Cloud Assist 效能的其他 API。

    3. 選用：選取「分享提示詞和答案，協助 Google 改進 Cloud Assist」。

    4. 選取「Enable Gemini Cloud Assist at no cost」。

  5. 按一下 [儲存]。

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

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

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

    2. 在「主體」欄中，找出要授予 Gemini Cloud Assist 存取權的主體，然後點選該列中的「編輯主體」圖示 。

    3. 在「編輯權限」窗格中，按一下 「新增其他角色」。

    4. 在「Select a role」(選取角色) 中，選取「Gemini Cloud Assist User」(Gemini Cloud Assist 使用者)。

    5. 按一下「新增其他角色」，然後選取「Cloud Asset Viewer」。

    6. 如果主體想取得目前無法存取產品的相關協助，您可能需要點選「新增其他角色」並選取其他角色，授予主體額外的 IAM 角色。如要查看 IAM 角色表，瞭解如何為不同產品啟用最佳的 Gemini Cloud Assist 體驗，請參閱使用 Gemini Cloud Assist 的 IAM 需求。

    7. 如果您的專案隸屬於使用自訂限制的機構，請參閱使用即時通訊所需的權限，確保 Gemini Cloud Assist 即時通訊不會遭到封鎖。

  7. (選用) 設定專案。

gcloud

  1. 在 Google Cloud 控制台中啟用 Cloud Shell。

    啟用 Cloud Shell

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

  3. 使用 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

  4. (選用) 使用 gcloud services enable 指令啟用建議的 API，方法與啟用 Gemini Cloud Assist API 相同。

  5. 在 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：專案的 ID，例如Google Cloud 1234567890。
      • PRINCIPAL：主體的識別碼，例如 user:cloudysanfrancisco@gmail.com。

      輸出內容是政策繫結清單，包含下列項目：

      - members:
  - user:PRINCIPAL
  role: roles/geminicloudassist.user

    2. 對角色 roles/cloudasset.viewer 重複執行上一個步驟。

    3. 如果主體想取得目前無法存取產品的相關協助，您可能需要授予額外的 IAM 角色。如要查看 IAM 角色表，瞭解如何為不同產品啟用最佳的 Gemini Cloud Assist 體驗，請參閱使用 Gemini Cloud Assist 的 IAM 需求。

    4. 如果您的專案隸屬於使用自訂限制的機構，請參閱使用即時通訊所需的權限，確保 Gemini Cloud Assist 即時通訊不會遭到封鎖。

  6. (選用) 設定專案。

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. 使用 services.enable 方法啟用下列其他必要 API，就像啟用 Gemini Cloud Assist API 一樣：

    • cloudasset.googleapis.com
    • designcenter.googleapis.com
    • appoptimize.googleapis.com
    • apphub.googleapis.com

  3. (選用) 使用 services.enable 方法啟用建議的 API，就像啟用 Gemini Cloud Assist API 一樣。

  4. 授予相關聯 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/cloudasset.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 政策。

    5. 如果主體想取得目前無法存取產品的相關協助，您可能需要授予額外的 IAM 角色。如要查看 IAM 角色表，瞭解如何為不同產品啟用最佳的 Gemini Cloud Assist 體驗，請參閱使用 Gemini Cloud Assist 的 IAM 需求。

    6. 如果您的專案隸屬於使用自訂限制的機構，請參閱使用即時通訊所需的權限，確保 Gemini Cloud Assist 即時通訊不會遭到封鎖。

  5. (選用) 設定專案。

為資料夾設定 Gemini Cloud Assist

下列步驟詳細說明如何使用 Google Cloud 控制台，為資料夾設定 Gemini Cloud Assist。您無法使用 Google Cloud CLI 或 API 為資料夾設定 Gemini Cloud Assist。

  1. 啟用必要和建議的 API。

    1. 前往「Gemini 管理」頁面。

      前往「Gemini 管理」頁面

    2. 在頁面頂端的專案挑選器中，選取資料夾資源。

    3. 選取「啟用 Cloud Assist API」。

      「為資料夾中的現有專案啟用 API」對話方塊隨即顯示。

    4. 在「為資料夾中的現有專案啟用 API」對話方塊中，選取「必要和建議的 API」部分中的 展開箭頭。

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

    6. 選用：選取「分享提示詞和答案，協助 Google 改進 Cloud Assist」。

    7. 選取「Enable Gemini Cloud Assist at no cost」。

      這個步驟會為資料夾中的所有專案啟用必要和所選的建議 API。如要為資料夾中的部分專案設定例外狀況，請在這些專案中設定「限制資源服務用量」組織政策限制，禁止啟用 API。詳情請參閱「限制資源用量」。

  2. 授予下列 IAM 角色，或建立自訂角色，並在資料夾中授予同等權限：

    • Gemini Cloud Assist 使用者
    • Cloud Asset Viewer

    如果主體想取得目前無法存取產品的相關協助，您可能需要授予其他 IAM 角色。如要查看 IAM 角色表，瞭解如何為不同產品啟用最佳的 Gemini Cloud Assist 體驗，請參閱使用 Gemini Cloud Assist 的 IAM 需求。

  3. 如果資料夾所屬的機構使用自訂限制，請查看使用 Gemini Cloud Assist 聊天室所需的權限，確保聊天室未遭到封鎖。

  4. 如果使用 Gemini Cloud Assist 處理應用程式，則必須在資料夾層級啟用應用程式管理功能。 這個步驟會建立管理專案，您必須將帳單帳戶連結至該專案。

    1. 返回「Gemini 管理」頁面。

      前往「Gemini 管理」頁面

    2. 選取「啟用應用程式管理」。

      「IAM 與管理」設定頁面隨即顯示。

    3. 在頁面的「應用程式啟用」部分，選取「啟用」。

      系統會顯示「啟用這個資料夾的應用程式 API」對話方塊。

    4. 選取「Enable」(啟用)。

      狀態列會顯示 API 啟用進度。API 啟用完成後，「IAM & Admin」(IAM 與管理員) 設定頁面會重新整理。

    5. 選取「管理帳單」。

      系統會顯示「已連結帳戶」頁面。

    6. 從清單中選取帳單帳戶，然後選取「設定帳戶」。

  5. 授予您在步驟 2 中授予資料夾的 IAM 角色，或建立自訂角色，並授予與先前步驟中建立的管理專案同等的權限。

    找出資料夾的管理專案：

    1. 返回「Gemini 管理」頁面。

      前往「Gemini 管理」頁面

    2. 在頁面頂端的專案挑選器中，選取資料夾資源。

    3. 選取「管理 Gemini Cloud Assist 設定」。

      系統會顯示「管理 Gemini Cloud Assist」對話方塊。

    4. 記下「管理專案」。

  6. (選用) 為資料夾中的專案設定設定。

後續步驟