設定 Gemini Code Assist (Standard 和 Enterprise)

您必須先完成本文件所述的設定步驟，團隊才能使用 Gemini Code Assist：

  1. 購買 Gemini Code Assist 訂閱方案。

  2. 為貴機構中的個別使用者指派授權。

  3. 在 Google Cloud 專案中啟用 Gemini for Google Cloud API。

  4. 在 Google Cloud 專案中授予 Identity and Access Management 角色。

  5. 貴機構的使用者安裝 Gemini Code Assist 外掛程式，即可在 IDE 中使用 Gemini Code Assist。

購買 Gemini Code Assist 訂閱方案

如需各版本支援的功能清單，請參閱「支援的功能」。

對於 Gemini Code Assist 的新客戶，如果其帳單帳戶從未訂閱 Gemini Code Assist，我們會自動套用抵免額，抵免額相當於前一個月最多 50 個免費授權，無論是哪個 Gemini Code Assist 版本皆然。請注意，初始免費授權額度分配完畢後，您就無法再增加免費額度數量。此外，您無法在第一個月內變更 Gemini Code Assist 版本。

2025 年 3 月 31 日前，Gemini Code Assist Enterprise 每位使用者每月只要 $19 美元，承諾使用 12 個月。歡迎與我們的銷售團隊聯絡，把握這項促銷優惠。

如果您與 Google Cloud 簽有合約，請先與我們的業務團隊聯絡，再購買訂閱。

  1. 前往 Google Cloud 專用 Gemini 頁面。

    前往 Gemini 版 Google Cloud

    Gemini for Google Cloud 頁面隨即開啟。

  2. 選取「取得 Gemini Code Assist」。請注意，如果您的帳單帳戶尚未購買 Gemini Code Assist 訂閱方案，系統會顯示「符合資格，可免費試用 30 天，最多 50 個授權」訊息。如果專案已啟用 Gemini Code Assist，這段文字會顯示「管理 Gemini Code Assist」。

    「取得 Gemini Code Assist 訂閱方案」頁面隨即開啟。

  3. 在「選取 Gemini Code Assist 訂閱版本」中，選取 Gemini Code Assist 版本。選取「比較 Gemini Code Assist 版本」，即可查看各個版本可用的功能詳細清單。

    然後選取「Continue」。

  4. 在「Configure subscription」中，填寫欄位來設定訂閱項目，包括：

    • 訂閱項目名稱。
    • 訂閱方案中的授權數量。請注意，如果您購買的是 Enterprise 版，則必須購買至少 10 個授權。
    • 訂閱期 (按月或按年付費)。年費方案提供折扣費率，且採按月收費，而非一次性付款。
    • 在承諾期 (按月或按年) 結束後，自動續約訂閱方案。自動續約功能可讓訂閱項目和授權保持有效。如果訂閱項目未自動續約，則會在目前的約期結束時終止，屆時您必須再次完成購買程序，並重新指派授權。

  5. 如要確認訂閱，請選取「繼續」。

  6. 如果您同意條款，請依序選取「我同意這筆購買交易的條款」和「確認訂閱」。

  7. 選取「下一步：管理 Gemini 授權指派作業」。

您已購買 Gemini Code Assist 訂閱項目。您現在需要管理貴機構的 Gemini 授權指派作業。

指派授權

每位使用者都必須取得授權，才能使用 Gemini Code Assist。

對於 Gemini Code Assist 的新客戶，如果其帳單帳戶從未訂閱 Gemini Code Assist，我們會自動套用抵免額，抵免額相當於前一個月最多 50 個免費授權，無論是哪個 Gemini Code Assist 版本皆然。請注意，初始免費授權額度分配完畢後，您就無法再增加免費額度數量。此外，您無法在第一個月內變更 Gemini Code Assist 版本。

主控台API

如要在 Google Cloud 控制台中將 Gemini 授權指派給個別使用者，您必須具備下列權限：

  • billing.accounts.get
  • consumerprocurement.orders.get
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.assign

  1. 前往 Gemini 管理員頁面。

    前往 Gemini 版 Google Cloud

  2. 選擇要變更的訂閱項目，然後按一下「修改訂閱項目」。

  3. 按一下「指派授權」。系統隨即會顯示使用者選取對話方塊。如要搜尋特定使用者，請在搜尋框中輸入對方的名稱。

  4. 從清單中選取一或多位使用者，然後點選「下一步」。

  5. 選擇要指派授權的 Gemini 服務。

  6. 按一下「指派授權」。

如要透過 API 指派 Gemini 授權，您必須具備 consumerprocurement.licensePools.assign 權限。

HTTP 方法：POST

網址：https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

更改下列內容：

  • BILLING_ACCOUNT_ID：帳單帳戶 ID
  • ORDER_ID：IAM 政策

要求主體：

    {
        "usernames": [
                  "dana@example.com",
                  "lee@example.com"
        ]
    }

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

{}

如果授權已成功指派，回應會是空白。

您現在需要在與這個帳單帳戶相關聯的一或多個專案中，啟用 Gemini for Google Cloud API。您必須至少在一個專案中啟用 Gemini Code Assist，使用者才會看到這項功能。

在 Google Cloud 專案中啟用 Gemini for Google Cloud API

本節說明在 Cloud 專案中啟用 Gemini for Google Cloud API 所需的步驟。

主控台gcloud

  1. 如要啟用 Gemini for Google Cloud API，請前往 Gemini for Google Cloud 頁面。

    前往 Gemini 版 Google Cloud

  2. 在專案選擇器中選取專案。

  3. 按一下「啟用」。

    頁面會更新，並顯示「已啟用」狀態。在所選 Cloud 專案中，Gemini 現已開放給具備必要 IAM 角色的所有使用者使用。

如要使用本機開發環境，請安裝並初始化 gcloud CLI。

  1. 在專案選取器選單中選取專案。

  2. 使用 gcloud services enable 指令為 Gemini 啟用 Gemini for Google Cloud API：

    gcloud services enable cloudaicompanion.googleapis.com

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

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

    將 PROJECT_ID 替換為您的 Cloud 專案 ID。

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

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

凡是具備必要 IAM 角色的使用者，現在都能在指定的 Cloud 專案中使用 Gemini for Google Cloud。

防火牆後方的使用者所需 API

除了啟用 Gemini for Google Cloud，防火牆後方的使用者可能還需要啟用下列 API：

  • oauth2.googleapis.com：用於登入 Google Cloud。
  • serviceusage.googleapis.com：用於檢查使用者的 Gemini Code Assist 專案是否正確設定。
  • cloudaicompanion.googleapis.com：Gemini 版 Google Cloud API 的主要端點。
  • cloudcode-pa.googleapis.com：提供 IDE 相關功能的內部 API。
  • cloudresourcemanager.googleapis.com：在 IDE 中用於專案挑選器。如果專案已在 settings.json 檔案中明確設定，則可能不需要使用 Resource Manager API。
  • people.googleapis.com：提供設定檔和聯絡人相關資訊的存取權。
  • firebaselogging-pa.googleapis.com：用於傳送產品遙測資料的內部 API，包括建議是否已接受的事件。
  • feedback-pa.googleapis.com：用於 IDE 內提交意見回饋的內部 API。
  • apihub.googleapis.com：由 Cloud Code API Browser 功能使用。

選用：設定 VPC Service Controls

如果貴機構設有服務範圍，則必須將下列資源新增至範圍：

  • Gemini for Google Cloud API
  • Gemini Code Assist API

如果您是在服務外圍範圍之外使用 Gemini Code Assist，則還需要修改入口政策，允許存取這些服務。

詳情請參閱「為 Gemini 設定 VPC Service Controls」。

在 Google Cloud 專案中授予 IAM 角色

本節說明授予使用者 Gemini for Google Cloud 使用者和服務使用者消費者 IAM 角色的必要步驟。

主控台gcloud

  1. 如要授予使用 Gemini 所需的 IAM 角色，請前往「IAM & Admin」頁面。

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

  2. 在「Principal」欄中找出要授予 Gemini 存取權的主體，然後按一下該列中的 「Edit principal」。

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

  4. 在「請選取角色」中，選取「Gemini for Google Cloud 使用者」。

  5. 按一下「Add another role」(新增其他角色)，然後選取「Service Usage Consumer」(服務用量消費者)。

  6. 按一下 [儲存]。

如要使用本機開發環境，請安裝並初始化 gcloud CLI。

  1. 在專案選取器選單中選取專案。

  2. 授予 Gemini for Google Cloud 使用者角色：

    gcloud projects add-iam-policy-binding  PROJECT_ID \
    --member=PRINCIPAL --role=roles/cloudaicompanion.user

    將 PRINCIPAL 替換為實體的 ID。這個 ID 的格式為 user|group|serviceAccount:email 或 domain:domain，例如 user:cloudysanfrancisco@gmail.com、group:admins@example.com、serviceAccount:test123@example.domain.com 或 domain:example.domain.com。

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

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

  3. 授予服務使用情形消費者角色：

    gcloud projects add-iam-policy-binding  PROJECT_ID \
    --member=PRINCIPAL --role=roles/serviceusage.serviceUsageConsumer

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

    - members:
  - user:PRINCIPAL
  role: roles/serviceusage.serviceUsageConsumer

詳情請參閱「授予單一角色」和 gcloud projects add-iam-policy-binding。

所有獲授這些角色的使用者，都可以在指定專案的 Google Cloud 控制台中存取 Gemini for Google Cloud 功能。詳情請參閱「Gemini 版 Google Cloud 總覽」。

在 IDE 中安裝 Gemini Code Assist 外掛程式

貴機構的使用者在偏好的 IDE 中安裝 Gemini Code Assist。如要瞭解詳情，請參考下列資源：

根據預設，Gemini Code Assist 會納入下列 IDE：

進階設定工作

您可以改用下列任一方法，而非使用 Google Cloud 控制台或 gcloud 授予預先定義的 IAM 角色：

  • 使用 IAM REST API 或 IAM 用戶端程式庫授予角色。

    如果您使用這些介面，請使用完整的角色名稱：

    • roles/cloudaicompanion.user
    • roles/serviceusage.serviceUsageConsumer

    如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

  • 建立及授予自訂角色。

    您建立的任何自訂角色都需要下列權限，才能存取 Gemini Code Assist：

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • cloudaicompanion.instances.completeCode
    • cloudaicompanion.instances.completeTask
    • cloudaicompanion.instances.generateCode
    • cloudaicompanion.instances.generateText
    • serviceusage.services.enable

  • 指派及管理授權。

    您建立的任何自訂角色都需要下列權限，才能存取 Gemini Code Assist：

    • consumerprocurement.orders.get
    • consumerprocurement.orders.licensePools..*
    • consumerprocurement.orders.licensePools.update
    • consumerprocurement.orders.licensePools.get
    • consumerprocurement.orders.licensePools.assign
    • consumerprocurement.orders.licensePools.unassign
    • consumerprocurement.orders.licensePools.enumerateLicensedUsers

另外請注意，如要讓上述任何權限生效，您必須在指派各項權限的 Google Cloud 專案中啟用 Gemini for Google Cloud API。

後續步驟