Mengonfigurasi saluran rilis Gemini Code Assist

Dokumen ini menjelaskan cara mengonfigurasi saluran rilis Gemini Code Assist untuk project menggunakan konsol Google Cloud atau API.

Kami merilis fitur Gemini Code Assist di berbagai saluran rilis. Anda dapat menetapkan setiap Google Cloud project ke satu saluran rilis, bergantung pada keseimbangan yang Anda pilih antara ketersediaan fitur dan stabilitas. Pengguna di organisasi Anda yang menggunakan Gemini Code Assist di IDE lokal dapat menggunakan fitur dan model berdasarkan saluran rilis yang dikonfigurasi untuk project.

Saluran rilis berikut tersedia:

  • Tersedia Secara Umum. Saluran rilis default. Memungkinkan Anda menggunakan model dan fitur yang tersedia secara umum. Perhatikan bahwa Anda dapat mengakses fitur pratinjau tertentu tanpa memilih ikut serta dalam saluran Pratinjau, menggunakan mekanisme alternatif pendaftaran Pratinjau. Fitur ini akan dapat diakses dalam saluran GA, tetapi masih tercakup dalam Persyaratan Penawaran Pra-GA.

  • Pratinjau. Memungkinkan Anda mengakses fitur pratinjau tertentu untuk Gemini Code Assist.

    Saat Anda mengaktifkan saluran rilis Pratinjau di sebuah project, Anda setuju atas nama pelanggan bahwa semua penggunaan Gemini Code Assist dalam project tersebut tunduk pada Persyaratan Penawaran Pra-GA dari Google Cloud Persyaratan Layanan Khusus Platform. Jangan gunakan saluran ini untuk project dan resource yang tidak cocok untuk digunakan dengan penawaran pra-GA.

Bagian berikut memberikan langkah-langkah yang diperlukan untuk menetapkan atau mengubah saluran rilis Gemini Code Assist Anda.

Sebelum memulai

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna membuat setelan dan binding yang mengontrol saluran rilis, minta administrator untuk memberi Anda peran Gemini for Google Cloud Settings Admin (roles/cloudaicompanion.settingsAdmin) di project.

Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

  • cloudaicompanion.releaseChannelSettings.create
  • cloudaicompanion.releaseChannelSettings.delete
  • cloudaicompanion.releaseChannelSettings.get
  • cloudaicompanion.releaseChannelSettings.list
  • cloudaicompanion.releaseChannelSettings.update
  • cloudaicompanion.dataSharingWithGoogleSettings.create
  • Konfigurasi saluran rilis menggunakan API:
    • cloudaicompanion.settingBindings.releaseChannelSettingsCreate
    • cloudaicompanion.settingBindings.releaseChannelSettingsDelete
    • cloudaicompanion.settingBindings.releaseChannelSettingsGet
    • cloudaicompanion.settingBindings.releaseChannelSettingsList
    • cloudaicompanion.settingBindings.releaseChannelSettingsUpdate
    • cloudaicompanion.settingBindings.releaseChannelSettingsUse
  • Mengonfigurasi berbagi perintah dan respons menggunakan API:
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
    • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
  • Melihat setelan administrator Gemini Code Assist:
    • cloudaicompanion.instances.queryEffectiveSetting
    • cloudaicompanion.instances.queryEffectiveSettingBindings

Mengonfigurasi saluran rilis Gemini Code Assist

Pilih salah satu opsi berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Admin untuk Gemini.

    Buka Admin untuk Gemini

  2. Klik Setelan di menu navigasi.

  3. Di bagian Saluran rilis untuk Gemini Code Assist di IDE lokal, pilih saluran rilis yang paling sesuai dengan kebutuhan Anda:

    Pratinjau

    1. Pilih Pratinjau.
    2. Tinjau detail saluran rilis Pratinjau dan persyaratan program Penguji Tepercaya, lalu klik Simpan perubahan.

    Tersedia Secara Umum

    1. Pilih GA.
    2. Klik Simpan perubahan.

API

  1. Buat setelan saluran rilis dan nilai khusus setelan:

    1. Dapatkan token autentikasi. Anda harus diautentikasi menggunakan autentikasi gcloud CLI untuk mendapatkannya:

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

    2. Buat setelan. Petunjuk ini menggunakan cURL untuk memanggil metode 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"

      Ganti kode berikut:

      • RELEASE_CHANNEL: saluran rilis, EXPERIMENTAL untuk Pratinjau atau STABLE untuk Tersedia Secara Umum.
      • CONTAINER_PROJECT_NAME: project ID project tempat resource binding disimpan. Ini adalah project induk binding.
      • RC_SETTING_ID: nama setelan unik—misalnya, rc1 untuk Release Channel.

      Output menunjukkan releaseChannel ditetapkan ke 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. Buat binding setelan saluran rilis:

        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"

      Ganti kode berikut:

      • TARGET_PROJECT_NAME: project target yang akan mengikat binding. Nama ini sering kali sama dengan project container. Namun, Anda dapat mengikat setelan ke beberapa project sehingga resource setelan tidak perlu diduplikasi.
      • CONTAINER_PROJECT_NAME: project ID dari project tempat resource binding disimpan. Ini adalah project induk binding.
      • RC_SETTING_ID: RC_SETTING_ID yang sama dengan yang Anda gunakan saat membuat setelan, tetapi ditambahkan dengan b1. Misalnya, gunakan rc1b1 untuk Release Channel.
      • RC_BINDING_ID: nama unik untuk binding setelan—misalnya, rc_binding.

      Output mencakup metadata operasi dalam format berikut:

      {
  "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. Opsional: Periksa status pembuatan binding setelan saluran rilis:

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

      Ganti kode berikut:

      • CONTAINER_PROJECT_NAME: project ID dari project tempat resource binding disimpan. Ini adalah project induk binding.
      • RC_BINDING_OPERATION_ID: ID operasi pembuatan binding setelan saluran rilis yang diberikan dalam respons pada langkah sebelumnya.

  2. Opsional: Buat setelan berbagi perintah dan respons serta nilai khusus setelan:

    1. Dapatkan token:

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

    2. Buat setelan:

      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"

      Ganti kode berikut:

      • CONTAINER_PROJECT_NAME: ID project induk
      • DSWG_SETTING_ID: nama setelan unik—misalnya, dswg1 untuk Data Sharing with Google

      Output menunjukkan enablePreviewDataSharing ditetapkan ke 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. Buat binding setelan perintah dan respons:

        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"

      Ganti kode berikut:

      • TARGET_PROJECT_NAME: project target tempat setelan harus diterapkan.
      • CONTAINER_PROJECT_NAME: ID project induk.
      • DSWG_SETTING_ID: DSWG_SETTING_ID yang sama dengan yang Anda gunakan saat membuat setelan, tetapi ditambahkan dengan b1. Misalnya, gunakan dswg1b1 untuk Data Sharing with Google.
      • DSWG_BINDING_ID: nama unik untuk binding setelan—misalnya, dswg_binding.

      Output mencakup metadata operasi dalam format berikut:

      {
"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. Opsional: Periksa status pembuatan binding setelan perintah dan respons:

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

      Ganti kode berikut:

      • CONTAINER_PROJECT_NAME: project ID dari project tempat resource binding disimpan. Ini adalah project induk binding.
      • DSWG_BINDING_OPERATION_ID: ID operasi pembuatan binding setelan perintah dan respons yang diberikan dalam respons pada langkah sebelumnya.

Langkah berikutnya