設定 Gemini Code Assist Standard 和 Enterprise

如要使用 Gemini Code Assist Standard 或 Enterprise，團隊必須先執行本文所述的設定步驟：

注意： 管理員通常會執行步驟 1 至 4。

1. 付費訂閱 Gemini Code Assist Standard 版或 Enterprise 版。

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

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

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

5. 貴機構的使用者安裝 Gemini Code Assist 外掛程式，即可在 IDE 中使用 Gemini Code Assist Standard 或 Enterprise。 Gemini CLI 使用者不必執行這個步驟。

購買 Gemini Code Assist 訂閱方案

如要查看各版本提供的功能清單，請參閱「支援的功能」。

如果帳單帳戶從未訂閱 Gemini Code Assist，我們會在第一個月份自動套用最多 50 個免費授權的等值抵免額，不論 Gemini Code Assist 版本為何。請注意，初始免費授權抵免額用完後，就無法增加免費抵免額。此外，您也無法在第一個月內變更 Gemini Code Assist 版本。

如果您與 Google Cloud 簽訂了現有合約，請先與我們的銷售團隊聯絡，再購買訂閱方案。

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

   前往 Gemini 管理員頁面

   系統隨即會開啟「Gemini 的管理員」頁面。

2. 選取「取得 Gemini Code Assist」。

   請注意，如果沒有必要的 consumerprocurement.orders.place 權限，這個按鈕會停用。如果專案關聯的帳單帳戶已有 Gemini Code Assist 訂閱方案，這個按鈕會顯示為「管理 Gemini Code Assist」，讓您編輯訂閱方案。

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

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

   然後選取「繼續」。

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

   • 訂閱方案名稱。
   • 訂閱方案中的授權數量。請注意，如要購買 Enterprise 版，至少須購買 10 個授權。
   • 訂閱週期 (月或年)。年約方案享有折扣費率，且按月收費，而非一次性付款。

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

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

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

你已購買 Gemini Code Assist Standard 或 Enterprise 訂閱方案。您現在必須管理貴機構的 Gemini 授權指派作業。

指派授權

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

如果帳單帳戶從未訂閱 Gemini Code Assist，我們會在第一個月份自動套用最多 50 個免費授權的等值抵免額，不論 Gemini Code Assist 版本為何。請注意，初始免費授權抵免額用完後，就無法增加免費抵免額。此外，您也無法在第一個月內變更 Gemini Code Assist 版本。

主控台

如要在 API 控制台中指派 Gemini 授權給個別使用者，您必須具備帳單帳戶的下列權限：

• billing.accounts.get
• billing.accounts.list
• consumerprocurement.orders.get
• consumerprocurement.orders.list
• consumerprocurement.orders.modify
• consumerprocurement.orders.place
• consumerprocurement.licensePools.enumerateLicensedUsers
• consumerprocurement.licensePools.get
• consumerprocurement.licensePools.update
• consumerprocurement.licensePools.assign
• consumerprocurement.licensePools.unassign

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

   前往 Gemini 版 Google Cloud

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

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

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

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

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

API

如要透過 API 指派 Gemini 授權，請使用 billingAccounts.orders.licensePool.assign 方法。

1. 請確認您具備帳單帳戶的 consumerprocurement.licensePools.assign Identity and Access Management 權限，該帳單帳戶包含您要指派授權的授權集區。

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

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   其中 USER_EMAILS 是以半形逗號分隔的清單，列出要指派授權的使用者帳戶。例如 "[e-mail]", "[e-mail]"。

3. 使用 cURL 呼叫方法：

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "X-Goog-User-Project: PROJECT_ID" \
     -H "Content-Type: application/json" \
     "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

   更改下列內容：

   • JSON_FILE_NAME：您在步驟 2 建立的 JSON 檔案路徑。
   • PROJECT_ID：專案的 ID。系統會根據這個專案，計算 API 要求相關的配額用量和費用。
   • BILLING_ACCOUNT_ID：與授權集區相關聯的帳單帳戶 ID。
   • ORDER_ID：訂單 ID。如果不知道訂單 ID，可以列出與帳單帳戶相關聯的訂單，藉此找出訂單 ID。

如果成功，回應會類似以下內容：

  {}

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

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

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

主控台

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

   前往 Gemini 版 Google Cloud

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

3. 按一下「啟用」。

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

gcloud

如要使用本機開發環境，請安裝並初始化 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。

設定防火牆，允許 IDE 與 Google 之間的 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 瀏覽器功能會使用這個檔案。
• lh3.googleusercontent.com 和 lh5.googleusercontent.com：用於取得使用者相片。

判斷 Google Cloud 預設網域的 IP 位址

如要從 IDE 啟用與 Google Cloud API 的連線，防火牆必須允許傳出 TCP 流量至 Google 公開記錄的 IP 位址範圍。這些範圍是由 Google 動態管理。

如要維護可存取 Google Cloud 網域的 IP 範圍清單，您有幾種做法：

• 使用我們發布的清單，或自動執行指令碼來取得 Google IP 位址範圍。
• 使用 private.googleapis.com 虛擬 IP。
• 使用 Private Service Connect。

選用：設定 VPC Service Controls

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

• Gemini for Google Cloud API
• Gemini Code Assist API

如果您從服務範圍外使用 Gemini Code Assist Standard 或 Enterprise，也需要修改連入政策，允許存取這些服務。

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

在 Google Cloud 專案中授予 IAM 角色

本節說明如何授予使用者「Gemini for Google Cloud 使用者」和「服務使用情形消費者」IAM 角色。

主控台

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

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

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

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

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

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

6. 按一下 [儲存]。

gcloud

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

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

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

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

   更改下列內容：

   • PROJECT_ID：您的 Cloud 專案 ID，例如 1234567890。
   • PRINCIPAL：主體的識別碼，例如 user:[e-mail]。

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

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

3. 針對 roles/serviceusage.serviceUsageConsumer 角色重複上一個步驟。

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

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

安裝 Gemini Code Assist 外掛程式

貴機構使用者在偏好的支援 IDE 中安裝 Gemini Code Assist 外掛程式

VS Code

1. 如要在 VS Code 中開啟「擴充功能」檢視畫面，請按一下 「擴充功能」，或按 Ctrl/Cmd+Shift+X。

2. 搜尋：Gemini Code Assist。

3. 按一下 [安裝]。

4. 如果系統提示，請重新啟動 VS Code。

   擴充功能安裝完成後，活動列中會顯示 Gemini Code Assist，即可開始使用。如要進一步設定 Gemini Code Assist 安裝作業，請使用頂層應用程式工具列指定偏好設定：依序前往「Code」 >「Settings」 >「Settings」>「Extensions」，然後搜尋 Gemini Code Assist。

IntelliJ

1. 依序點選 settings「IDE and Project Settings」 >「Plugins」。
2. 在「Marketplace」分頁中，搜尋 Gemini Code Assist。
3. 按一下「安裝」安裝外掛程式。
4. 安裝完成後，按一下「Restart IDE」。

5. IDE 重新啟動後，活動列中會顯示 Gemini Code Assist。

   

現在使用者可以在 IDE 中使用 Gemini Code Assist Standard 版或 Enterprise 版。進一步瞭解支援的功能：

• 程式碼功能總覽
• 即時通訊功能總覽

歡迎參考下列指南，輕鬆開始使用：

• 透過 Gemini Code Assist 編寫程式碼
• 與 Gemini Code Assist 對話

Gemini Code Assist 快取資訊的目錄清單

下表列出 Gemini Code Assist 儲存擴充功能資訊 (例如驗證權杖) 的目錄：

Windows

• %LOCALAPPDATA%/cloud-code
• %LOCALAPPDATA%/google-vscode-extension

macOS

• ~/Library/Application Support/cloud-code
• ~/Library/Application Support/google-vscode-extension

Linux

• ~/.cache/cloud-code
• ~/.cache/google-vscode-extension

登入 Google 並選取 Google Cloud 專案

使用者在 IDE 安裝 Gemini Code Assist 後，必須登入 Google 帳戶。如果這是他們第一次在 IDE 中使用 Gemini Code Assist Standard 或 Enterprise，則須選取 Google Cloud 專案。

VS Code

如果選取的 Google Cloud 專案未啟用 Gemini for Google Cloud API，您會收到通知，並可選擇從 IDE 啟用 API。在通知視窗中選取「啟用 API」，為專案啟用 API。詳情請參閱「為專案設定 Gemini Code Assist Standard 版和 Enterprise 版」。

如要直接在 IDE 中按照「使用 Gemini Code Assist 編寫程式碼」逐步操作，請點選「啟動 VS Code」，然後按照逐步操作中的步驟連線至 Google Cloud，並啟用 Gemini Code Assist Standard 或 Enterprise。

啟動 VS Code

如果沒有，請按照下列步驟操作：

1. 啟動 IDE。

2. 在活動列中，按一下「Gemini Code Assist」。

3. 在 Gemini Code Assist 對話窗格中，按一下「登入 Google Cloud」。

4. 系統提示您允許 Gemini Code Assist 開啟外部網站時，按一下「開啟」。

5. 按照畫面上的提示登入 Google 帳戶。

6. 系統詢問您是否從 Google 下載 Gemini Code Assist 時，請點按「登入」。

   注意： 如果登入嘗試持續逾時，請參閱「登入嘗試持續逾時」已知問題，進一步瞭解如何排解問題。

   您已連結到 Google Cloud。

   接著，如要選取已啟用 Gemini for Google Cloud API 的 Google Cloud 專案，請按照下列步驟操作：

7. 在 Gemini Code Assist 狀態列中，點選「Gemini Code Assist」。

   

8. 在「Gemini Code Assist」選單中，選取「Select Gemini Code project」(選取 Gemini Code 專案)。

9. 選取已啟用 Gemini for Google Cloud API 的 Google Cloud 專案。

   Gemini Code Assist Standard 版或 Enterprise 版已可使用。

   

IntelliJ

如要登入 Google 帳戶，請按照下列步驟操作：

1. 在活動列中，按一下 spark「Gemini Code Assist」。

2. 按一下「登入 Google」。

3. 在網路瀏覽器開啟的頁面中，選取 Google 帳戶。

4. 在要求確認您是從 Google 下載這個應用程式的畫面上，按一下「登入」。

   Gemini Code Assist 現已取得存取您帳戶的授權。

   接下來，如果您是第一次在 IDE 中使用 Gemini Code Assist Standard 或 Enterprise，請按照下列步驟選取 Google Cloud 專案：

5. 返回 IDE。在 Gemini Code Assist 工具視窗中，如果您同意讓 Google 為您啟用所選專案使用 Gemini Code Assist 所需的 API，請按一下「選取 GCP 專案」繼續操作。

6. 在「Select Google Cloud Project」(選取 Google Cloud 專案) 對話方塊中，搜尋並選取您的 Google Cloud 專案，然後按一下「OK」(確定)。

7. 按一下「完成」。

選取已啟用 Gemini Code Assist API 的 Google Cloud 專案。您現在可以在 IDE 中使用 Gemini Code Assist Standard 版或 Enterprise 版了！

進階設定工作

您不必使用 API 控制台或 gcloud 授予預先定義的 IAM 角色，可以改用下列任一方式：

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

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

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

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

• 建立及授予自訂角色。

  您建立的任何自訂角色都必須具備下列權限，才能存取 Gemini Code Assist Standard 版和 Enterprise 版：

  • cloudaicompanion.companions.generateChat
  • cloudaicompanion.companions.generateCode
  • cloudaicompanion.instances.completeCode
  • cloudaicompanion.instances.completeTask
  • cloudaicompanion.instances.generateCode
  • cloudaicompanion.instances.generateText
  • cloudaicompanion.instances.exportMetrics
  • cloudaicompanion.instances.queryEffectiveSetting
  • cloudaicompanion.instances.queryEffectiveSettingBindings
  • 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。

後續步驟

• 進一步瞭解 Gemini 版 Google Cloud 提供的生成式 AI 輔助類型。
• 瞭解 Gemini for Google Cloud 如何使用您的資料。
• 瞭解如何存取及管理 Gemini Code Assist Standard 和 Enterprise 管理員控制選項。
• 瞭解如何為 Gemini Code Assist Enterprise 設定程式碼自訂功能。
• 為 Gemini Code Assist Standard 版和 Enterprise 版設定 VPC Service Controls。