Mengonfigurasi berbagi perintah dan respons untuk Gemini Cloud Assist

Anda dapat mengonfigurasi berbagi perintah dan respons Gemini Cloud Assist untuk projectGoogle Cloud melalui konsol Google Cloud atau API. Jika diaktifkan, Google akan memproses dan menyimpan perintah dan respons anonim dari semua pengguna Gemini Cloud Assist dalam project hingga dua tahun untuk peningkatan produk, tetapi tidak pernah menggunakan input Anda untuk melatih atau menyempurnakan LLM dasar. 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 ditentukan sebelumnya, yaitu Admin Gemini Cloud Assist (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.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 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 yang 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 harus diterapkan.
    • SETTING_ID: Gunakan SETTING_ID yang sama saat Anda membuat setelan, tetapi tambahkan dengan 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 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 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/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 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/locations/global/dataSharingWithGoogleSettings/SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "enablePreviewDataSharing": false
}

Langkah berikutnya