設定 Gemini Cloud Assist

Gemini Cloud Assist 提供情境式 AI 指引，協助您設計、操作及最佳化雲端應用程式和基礎架構。團隊成員必須先完成專案或資料夾的初始設定，才能使用這些功能。

為專案設定 Gemini Cloud Assist

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

控制台

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

    前往 Gemini 版 Google Cloud

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

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

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

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

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

    3. 選用：選取「Help Google improve Cloud Assist by sharing your prompts and answers」(分享提示詞和答案，協助 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 角色，方法是按一下「Add another role」(新增其他角色)，然後選取其他角色。如要查看可為不同產品提供最佳 Gemini Cloud Assist 體驗的 IAM 角色表格，請參閱「使用 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 Code 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：主體的ID，例如 user:cloudysanfrancisco@gmail.com。

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

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

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

    3. 如果主體想取得目前無法存取產品的相關協助，您可能需要授予其他 IAM 角色。如要查看可為不同產品提供最佳 Gemini Cloud Assist 體驗的 IAM 角色表格，請參閱「使用 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 Code 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 角色。請參閱「使用 Gemini Cloud Assist 的 IAM 需求」，查看 IAM 角色表格，瞭解如何為不同產品提供最佳 Gemini Cloud Assist 體驗。

    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。如要為資料夾中的部分專案設定例外狀況，請在這些專案中設定限制資源服務用量 組織政策限制，封鎖 API 啟用作業。詳情請參閱「限制資源用量」。

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

    • Gemini Cloud Assist 使用者
    • Cloud Asset Viewer

    如果主體想請 Gemini 協助調查目前無法存取的產品，您可能需要授予其他 IAM 角色。如要查看可為不同產品提供最佳 Gemini Cloud Assist 體驗的 IAM 角色表格，請參閱「使用 Gemini Cloud Assist 的 IAM 需求」。

  3. 如果您的資料夾屬於使用自訂限制的機構，請查看使用 Gemini Cloud Assist 對話功能所需的權限，確保 Gemini Cloud Assist 對話功能未遭封鎖。

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

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

      前往 Gemini 管理頁面

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

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

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

      「Enable application APIs on this folder」(啟用這個資料夾的應用程式 API) 對話方塊隨即顯示。

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

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

    5. 選取「管理帳單」。

      「已連結帳戶」頁面隨即顯示。

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

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

    找出資料夾的管理專案：

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

      前往 Gemini 管理頁面

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

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

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

    4. 請記下「管理專案」。

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

後續步驟