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 menyetel setiap project ke satu saluran rilis, bergantung pada keseimbangan yang Anda pilih antara ketersediaan dan stabilitas fitur. Google Cloud 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 untuk menggunakan 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 kualitas 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 dalam 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 menyetel atau mengubah saluran rilis Gemini Code Assist Anda.

Sebelum memulai

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

Peran yang diperlukan

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

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
• 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 administrator Gemini untuk Google Cloud :
• 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 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 dari 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 mengikat 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 dari 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 pengikatan setelan saluran rilis pembuatan:

      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 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 harus diterapkan.
      • CONTAINER_PROJECT_NAME: ID project 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 pengikatan 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 pengikatan setelan perintah dan respons yang diberikan dalam respons pada langkah sebelumnya.

Langkah berikutnya

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