Mengonfigurasi saluran rilis Gemini Code Assist

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

Kami merilis fitur Gemini Code Assist di saluran rilis yang berbeda. 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 mereka 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 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 dan, secara opsional, memberikan masukan dan data penggunaan untuk membantu Google meningkatkan rilis mendatang. Perhatikan bahwa saat ini tidak ada fitur berbeda di saluran rilis Pratinjau.

  Saat Anda mengaktifkan saluran rilis Pratinjau di project, Anda menyetujui atas nama pelanggan bahwa semua penggunaan Gemini Code Assist di 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.

Sebelum memulai

• Pastikan project Anda terlampir ke akun penagihan. Google Cloud Untuk mengetahui informasi selengkapnya, lihat Memverifikasi status penagihan project.

Peran yang diperlukan

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

Untuk melihat izin yang benar-benar diperlukan, perluas 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
• Mengonfigurasi 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 Gemini untuk Google Cloud administrator:
• cloudaicompanion.instances.queryEffectiveSetting
• cloudaicompanion.instances.queryEffectiveSettingBindings

Mengonfigurasi saluran rilis Gemini Code Assist

Pilih salah satu opsi berikut:

Konsol

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

   Buka Gemini untuk Google Cloud

   Halaman Gemini untuk Google Cloud akan dimuat.

2. Klik Setelan di menu navigasi.

   Halaman Setelan akan dimuat.

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, baik 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 menampilkan releaseChannel yang 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 terikat dengan binding. Project ini sering kali sama dengan project penampung. Namun, Anda dapat mengikat setelan ke beberapa project sehingga resource setelan tidak perlu diduplikasi.
      • CONTAINER_PROJECT_NAME: project ID project tempat resource binding disimpan. Ini adalah project induk binding.
      • RC_SETTING_ID: RC_SETTING_ID yang sama 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 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: project ID induk
      • DSWG_SETTING_ID: nama setelan unik—misalnya, dswg1 untuk Data Sharing with Google

      Output menampilkan enablePreviewDataSharing yang 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 akan diterapkan.
      • CONTAINER_PROJECT_NAME: project ID induk.
      • DSWG_SETTING_ID: DSWG_SETTING_ID yang sama 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 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

• Pelajari harga Gemini Code Assist.
• Lihat setelan administrator Gemini Code Assist lainnya.