Mengonfigurasi berbagi perintah dan respons untuk Gemini Cloud Assist

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

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

Jika diaktifkan, Google akan memproses perintah dan respons semua pengguna Gemini Cloud Assist dalam project untuk tujuan peningkatan kualitas 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 menyempurnakan model LLM apa pun.

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 Identity and Access Management (IAM) yang telah ditetapkan sebelumnya, yaitu Gemini Cloud Assist Admin (roles/geminicloudassist.admin), 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 khususnya untuk TARGET_PROJECT.

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

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

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

Mengaktifkan berbagi perintah dan respons untuk Gemini Cloud Assist

Pilih salah satu opsi berikut:

Konsol

1. Buka konsol Google Cloud .

   Buka konsol Google Cloud

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

   Panel Cloud Assist akan terbuka.

3. Klik Tindakan lainnya (), lalu klik Setelan Bantuan Cloud dari menu drop-down.

   Panel setelan Kelola Gemini Cloud Assist akan terbuka.

4. Di bagian Berbagi data untuk Gemini Cloud Assist, pastikan opsi Bantu Google meningkatkan kualitas 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_NAME/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"
      

      Ganti kode berikut:

      • CONTAINER_PROJECT_NAME: Masukkan project ID 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_NAME/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_NAME",
         "product": "GEMINI_CLOUD_ASSIST"
         }' \
       "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings?settingBindingId=BINDING_ID"
   

   Ganti kode berikut:

   • TARGET_PROJECT_NAME: 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/<var>CONTAINER_PROJECT_NAME</var>/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/<var>TARGET_PROJECT_NAME</var>/locations/global/dataSharingWithGoogleSettings/<var>SETTING_ID</var>/settingBindings/<var>BINDING_ID</var>",
       "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 konsol Google Cloud .

   Buka konsol Google Cloud

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

   Panel Cloud Assist akan terbuka.

3. Klik Tindakan lainnya (), lalu klik Setelan Bantuan Cloud dari menu drop-down.

   Panel setelan Kelola Gemini Cloud Assist akan terbuka.

4. Di bagian Berbagi data untuk Gemini Cloud Assist, pastikan opsi Bantu Google meningkatkan kualitas 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_NAME/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_NAME: Masukkan project ID 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_NAME/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