設定 Gemini Code Assist 發布管道

本文說明如何使用 Google Cloud 控制台或 API，為專案設定 Gemini Code Assist 發布管道。

我們會在不同發布管道中推出 Gemini Code Assist 功能。您可以根據所選的可用功能與穩定性平衡，為每個 Google Cloud 專案設定單一發布版本。貴機構使用者在本機 IDE 中使用 Gemini Code Assist 時，可根據專案設定的發布管道，使用相關功能和模型。

您可以使用下列發布版本：

  • 正式發布。預設發布版本。可使用正式發布版模型和功能。請注意，您可以使用其他預先發布版註冊機制，存取特定預先發布版功能，不必選擇加入預先發布版管道。這些功能將在正式發布管道中提供，但仍受《正式發布前產品條款》規範。

  • 預覽。可存取 Gemini Code Assist 的特定預先發布功能，並視需要提供意見和使用資料，協助 Google 日後推出更優質的版本。請注意，目前預先發布版管道沒有任何獨特功能。

    為專案啟用預先發布版發布管道，即表示您代表客戶同意，該專案中所有 Gemini Code Assist 使用行為均須遵守《Google Cloud 平台專屬服務條款》的《正式發布前產品條款》。請勿將這個管道用於不適合與正式發布前產品搭配使用的專案和資源。

以下各節說明如何設定或變更 Gemini Code Assist 發布管道。

事前準備

必要的角色

如要建立可控管發布管道的設定和繫結，請管理員授予您專案的「Gemini for Google Cloud 設定管理員」(roles/cloudaicompanion.settingsAdmin) 角色。

如要查看確切的必要權限，請展開「必要權限」部分：

所需權限

  • cloudaicompanion.releaseChannelSettings.create
  • cloudaicompanion.releaseChannelSettings.delete
  • cloudaicompanion.releaseChannelSettings.get
  • cloudaicompanion.releaseChannelSettings.list
  • cloudaicompanion.releaseChannelSettings.update
  • cloudaicompanion.dataSharingWithGoogleSettings.create
  • 使用 API 設定發布管道：
    • cloudaicompanion.settingBindings.releaseChannelSettingsCreate
    • cloudaicompanion.settingBindings.releaseChannelSettingsDelete
    • cloudaicompanion.settingBindings.releaseChannelSettingsGet
    • cloudaicompanion.settingBindings.releaseChannelSettingsList
    • cloudaicompanion.settingBindings.releaseChannelSettingsUpdate
    • cloudaicompanion.settingBindings.releaseChannelSettingsUse
  • 使用 API 設定提示和回覆共用功能：
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
  • 查看 Gemini for Google Cloud 管理員設定：
    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings

設定 Gemini Code Assist 發布管道

選取下列選項之一：

主控台

  1. 前往 Google Cloud 控制台的「Gemini 管理員」頁面。

    前往 Gemini for Google Cloud

    系統會載入「Gemini for Google Cloud」頁面。

  2. 按一下導覽選單中的「設定」。

    載入「設定」頁面。

  3. 在「本機 IDE 中的 Gemini Code Assist 發布管道」部分，選取最符合需求的發布管道：

    預覽

    1. 選取「預覽」。
    2. 查看「預先發布」發布管道詳細資料和「信任的測試人員」計畫條款，然後按一下「儲存變更」。

    正式發布版

    1. 選取「GA」GA。
    2. 按一下 [儲存變更]。

API

  1. 建立發布版本設定和設定專屬值：

    1. 取得驗證權杖。您必須使用 gcloud CLI 驗證取得這項權杖：

      TOKEN=$(gcloud auth print-access-token)

    2. 建立設定。這些操作說明會使用 cURL 呼叫 API 方法：

        curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
      "release_channel": "RELEASE_CHANNEL",
    } ' -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings?release_channel_setting_id=RC_SETTING_ID"

      更改下列內容：

      • RELEASE_CHANNEL：發布管道，可以是「預覽」的 EXPERIMENTAL，也可以是「正式版」的 STABLE。
      • CONTAINER_PROJECT_NAME：儲存繫結資源的專案 ID。這是繫結的父項專案。
      • RC_SETTING_ID：專屬設定名稱，例如 rc1 (適用於 Release Channel)。

      輸出結果會顯示 releaseChannel 設為 RELEASE_CHANNEL：

      {
  "name": "projects/CONTAINER_PROJECT_NAME
/locations/global/releaseChannelSettings/RC_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "releaseChannel": RELEASE_CHANNEL
}

    3. 建立發布版本設定繫結：

        curl \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
      "target": "projects/TARGET_PROJECT_NAME",
      "product": "GEMINI_CODE_ASSIST"
    }' \
  -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings?setting_binding_id=RC_BINDING_ID"

      更改下列內容：

      • TARGET_PROJECT_NAME：繫結應繫結的目標專案。這通常與容器專案相同。不過，您可以將設定繫結至多個專案，這樣就不必重複設定資源。
      • CONTAINER_PROJECT_NAME：儲存繫結資源的專案 ID。這是繫結的父項專案。
      • RC_SETTING_ID：與您建立設定時使用的 RC_SETTING_ID 相同，但附加了 b1。例如，使用 rc1b1 代表 Release Channel。
      • RC_BINDING_ID：設定繫結的專屬名稱，例如 rc_binding。

      輸出內容會包含下列格式的作業中繼資料：

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
    "createTime": "2025-01-23T15:27:50.076075570Z",
    "target": "projects/TARGET_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings/RC_BINDING_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

    4. 選用：檢查發布管道設定繫結建立作業的狀態：

      curl -H "Authorization: Bearer $TOKEN" \
https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID

      更改下列內容：

      • CONTAINER_PROJECT_NAME：儲存繫結資源的專案 ID。這是繫結的父項專案。
      • RC_BINDING_OPERATION_ID：上一個步驟的回應中提供的發布管道設定繫結建立作業 ID。

  2. 選用：建立提示和回覆共用設定，以及設定專屬值：

    1. 取得權杖：

      TOKEN=$(gcloud auth print-access-token)

    2. 建立設定：

      curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
    "enable_preview_data_sharing": true,
  } ' -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=DSWG_SETTING_ID"

      更改下列內容：

      • CONTAINER_PROJECT_NAME：父項專案 ID
      • DSWG_SETTING_ID：專屬設定名稱，例如 Data Sharing with Google 的 dswg1

      輸出結果會顯示 enablePreviewDataSharing 設為 true：

      {
  "name": "projects/CONTAINER_PROJECT_NAME
/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "enablePreviewDataSharing": true
}

    3. 建立提示和回應設定繫結：

        curl \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
      "target": "projects/TARGET_PROJECT_NAME",
      "product": "GEMINI_CODE_ASSIST"
    }' \
  -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings?setting_binding_id=DSWG_BINDING_ID"

      更改下列內容：

      • TARGET_PROJECT_NAME：要套用設定的目標專案。
      • CONTAINER_PROJECT_NAME：父項專案 ID。
      • DSWG_SETTING_ID：與您建立設定時使用的 DSWG_SETTING_ID 相同，但附加了 b1。例如，使用 dswg1b1 代表 Data Sharing with Google。
      • DSWG_BINDING_ID：設定繫結的專屬名稱，例如 dswg_binding。

      輸出內容會包含下列格式的作業中繼資料：

      {
"name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID",
"metadata": {
  "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
  "createTime": "2025-01-23T15:27:50.076075570Z",
  "target": "projects/TARGET_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings/DSWG_BINDING_ID",
  "verb": "create",
  "requestedCancellation": false,
  "apiVersion": "v1"
},
"done": false
}

    4. 選用：檢查提示和回覆設定繫結建立作業的狀態：

      curl -H "Authorization: Bearer $TOKEN" \
https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID

      更改下列內容：

      • CONTAINER_PROJECT_NAME：儲存繫結資源的專案 ID。這是繫結的父項專案。
      • DSWG_BINDING_OPERATION_ID：上一步回應中提供的提示和回應設定繫結建立作業 ID。

後續步驟