設定 Gemini Code Assist Standard 和 Enterprise

主控台

如要在Google Cloud 控制台中將 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 身分與存取權管理 (IAM) 權限。

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

   {
     "usernames": [
       USER_EMAILS
     ]
   }
   

   其中 USER_EMAILS 是以逗號分隔的清單，列出要指派授權的使用者帳戶。例如："dana@example.com", "lee@example.com"。

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，可以列出與帳單帳戶相關聯的訂單來擷取。

如果成功，回應會與下列內容相似：

  {}

主控台

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

   前往 Gemini 版 Google Cloud

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

3. 按一下「啟用」。

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

gcloud CLI

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

   Activate Cloud Shell

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

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

   gcloud services enable cloudaicompanion.googleapis.com
   

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

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

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

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

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

主控台

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

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

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

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

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

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

6. 按一下 [儲存]。

gcloud CLI

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

   Activate Cloud Shell

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

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

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

   更改下列內容：

   • PROJECT_ID：Google Cloud 專案的 ID，例如 1234567890。
   • PRINCIPAL：主要對象的ID，例如 user:cloudysanfrancisco@gmail.com。

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

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

3. 針對 roles/serviceusage.serviceUsageConsumer 角色重複執行上述步驟。

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

VS Code

1. 如要在 VS Code 中開啟「Extensions」檢視畫面，請按一下 「Extensions」，或按下 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 和專案設定」>「外掛程式」。
2. 在「Marketplace」分頁中，搜尋 Gemini Code Assist。
3. 按一下「Install」安裝外掛程式。
4. 安裝完成後，按一下「Restart IDE」。

5. 重新啟動 IDE 後，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

VS Code

如果您選取的 Google Cloud 專案未啟用 Gemini for Google Cloud API，系統會傳送通知，讓您選擇是否要透過 IDE 啟用 API。選取通知視窗中的「啟用 API」，即可為專案啟用 API。如需更多資訊，請參閱「為專案設定 Gemini Code Assist Standard 和 Enterprise」。

如果您想直接在 IDE 中按照「使用 Gemini Code Assist 編寫程式碼」逐步操作說明，請按一下「Launch VS Code」，然後按照逐步操作說明中的步驟，連線至 Gemini Code Assist Standard 或 Enterprise，並啟用這項服務。 Google Cloud

啟動 VS Code

否則請按照下列步驟操作：

1. 啟動 IDE。

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

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

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

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」。

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 專案，然後按一下「OK」。

7. 按一下「完成」。