Mengonfigurasi berbagi perintah dan respons untuk Gemini Cloud Assist

Catatan: Penggunaan penawaran pratinjau Gemini Cloud Assist ini tunduk pada Perjanjian, Google Cloud termasuk Persyaratan Penawaran Pra-GA dalam Google Cloud Persyaratan Khusus Layanan, sebagaimana dilengkapi dengan persyaratan untuk Program Penguji Tepercaya Google Cloud Gemini.

Dokumen ini menjelaskan cara mengonfigurasi berbagi perintah dan respons Gemini Cloud Assist untuk project menggunakankonsol atau API. Google Cloud

Jika diaktifkan, Google akan memproses perintah dan respons semua pengguna Gemini Cloud Assist dalam project untuk tujuan peningkatan produk, yang membantu Google meningkatkan kualitas Gemini Cloud Assist. Google menyimpan perintah dan respons anonim yang dikirimkan dari project selama maksimal dua tahun. Perintah dan respons organisasi Anda tidak pernah digunakan untuk melatih atau menyetel model LLM.

Anda dapat mengubah setelan ini kapan saja.

Sebelum memulai

Untuk mendapatkan izin yang diperlukan guna mengonfigurasi berbagi perintah dan respons untuk Gemini Cloud Assist, minta administrator Anda untuk memberi Anda peran bawaan Gemini Cloud Assist Admin (roles/geminicloudassist.admin) Identity and Access Management (IAM), yang mencakup semua izin yang diperlukan untuk melihat dan mengubah setelan administrator Gemini Cloud Assist.

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

Izin yang diperlukan

• cloudaicompanion.dataSharingWithGoogleSettings.create
• cloudaicompanion.dataSharingWithGoogleSettings.update
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
  • Jika Anda menggunakan permintaan API langsung, izin ini diperlukan secara khusus untuk TARGET_PROJECT.

Berikut adalah izin tambahan yang diperlukan jika Anda menggunakan Google Cloud konsol:

• cloudaicompanion.instances.queryEffectiveSetting
• cloudaicompanion.instances.queryEffectiveSettingBindings
• cloudaicompanion.dataSharingWithGoogleSettings.list
• cloudaicompanion.dataSharingWithGoogleSettings.get
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsGet
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUpdate
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsDelete

Anda mungkin bisa mendapatkan izin ini dengan peran standar atau peran khusus lainnya.

Mengaktifkan berbagi perintah dan respons untuk Gemini Cloud Assist

Pilih salah satu opsi berikut:

Konsol

1. Buka Google Cloud konsol.

   Buka Google Cloud konsol

2. Di halaman Google Cloud konsol mana pun, klik spark Open or close Gemini Cloud Assist chat.

   Panel Cloud Assist akan terbuka.

3. Klik More actions (), lalu klik Cloud Assist Settings dari menu drop-down.

   Panel setelan Manage Gemini Cloud Assist akan terbuka.

4. Di bagian Berbagi data untuk Gemini Cloud Assist, pastikan Bantu Google meningkatkan Gemini Cloud Assist dengan membagikan perintah dan respons Anda dipilih.

5. Klik Simpan.

API

Untuk mengaktifkan berbagi data untuk Gemini Cloud Assist, buat setelan dengan metode dataSharingWithGoogleSettings.create, dan terapkan setelan menggunakan metode settingBindings.create terkait.

1. Buat setelan dan nilai khusus setelan:

   1. Dapatkan token autentikasi:

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

   2. Jalankan perintah berikut untuk membuat setelan:

      curl -X POST \
        -H "Authorization: Bearer $TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
          "enablePreviewDataSharing": true
          }' \
        "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"
      

      Ganti kode berikut:

      • CONTAINER_PROJECT: Masukkan ID project induk.
      • SETTING_ID: Masukkan nama setelan unik, seperti dswg1 untuk Data Sharing with Google.

      Jika berhasil, perintah akan menampilkan isi respons yang menunjukkan enablePreviewDataSharing ditetapkan ke true:

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

      Untuk mengetahui informasi selengkapnya tentang autentikasi, lihat Melakukan autentikasi untuk menggunakan REST.

2. Buat binding setelan:

     curl -X POST \
       -H "Authorization: Bearer $TOKEN" \
       -H 'Content-Type: application/json' \
       -d '{
         "target": "projects/TARGET_PROJECT",
         "product": "GEMINI_CLOUD_ASSIST"
         }' \
       "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings?settingBindingId=BINDING_ID"
   

   Ganti kode berikut:

   • TARGET_PROJECT: Masukkan project target tempat setelan akan diterapkan.
   • SETTING_ID: Gunakan SETTING_ID yang sama saat Anda membuat setelan, tetapi tambahkan b1. Misalnya, gunakan dswg1b1 untuk Data Sharing with Google.

   Jika berhasil, perintah akan menampilkan metadata operasi dalam format berikut:

   {
     "name": "projects/CONTAINER_PROJECT/locations/global/operations/operation-1737646069712-62c6140bb04bb-49261230-43701daf",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
       "createTime": "2025-01-23T15:27:50.076075570Z",
       "target": "projects/TARGET_PROJECT/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings/BINDING_ID",
       "verb": "create",
       "requestedCancellation": false,
       "apiVersion": "v1"
     },
     "done": false
   }
   

Menonaktifkan berbagi perintah dan respons untuk Gemini Cloud Assist

Pilih salah satu opsi berikut:

Konsol

1. Buka Google Cloud konsol.

   Buka Google Cloud konsol

2. Di halaman Google Cloud konsol mana pun, klik spark Open or close Gemini Cloud Assist chat.

   Panel Cloud Assist akan terbuka.

3. Klik More actions (), lalu klik Cloud Assist Settings dari menu drop-down.

   Panel setelan Manage Gemini Cloud Assist akan terbuka.

4. Di bagian Berbagi data untuk Gemini Cloud Assist, pastikan Bantu Google meningkatkan Gemini Cloud Assist dengan membagikan perintah dan respons Anda tidak dipilih.

5. Klik Simpan.

API

Untuk menonaktifkan berbagi perintah dan respons untuk Gemini Cloud Assist, gunakan metode dataSharingWithGoogleSettings.patch.

1. Dapatkan token:

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

2. Jalankan perintah berikut untuk menonaktifkan setelan:

   curl -X PATCH \
     -H "Authorization: Bearer $TOKEN" \
     -H 'Content-Type: application/json' \
     -d '{
       "enablePreviewDataSharing": false
       } ' \
     "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"
   

   Perintah PATCH ini hanya berhasil jika resource setelan sudah ada sejak Anda mengaktifkan berbagi perintah dan respons.

   Ganti kode berikut:

   • CONTAINER_PROJECT: Masukkan ID project induk.
   • SETTING_ID: Masukkan nama setelan yang ada, seperti dswg1 untuk Data Sharing with Google.

   Jika berhasil, perintah akan menampilkan isi respons yang menunjukkan enablePreviewDataSharing ditetapkan ke false:

   {
     "name": "projects/CONTAINER_PROJECT/locations/global/dataSharingWithGoogleSettings/SETTING_ID",
     "createTime": "2025-01-23T15:22:49.717166932Z",
     "updateTime": "2025-01-23T15:22:49.717166932Z",
     "enablePreviewDataSharing": false
   }
   

Langkah berikutnya

• Mempelajari setelan administrator Gemini Cloud Assist

• Menonaktifkan Gemini Cloud Assist