Mengonfigurasi berbagi perintah dan respons untuk Gemini Cloud Assist

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

Sebelum memulai

  • Pastikan Google Cloud project Anda dilampirkan ke akun penagihan.

(Opsional) Berikan izin IAM

Untuk mengonfigurasi berbagi perintah dan respons untuk Gemini Cloud Assist, Anda harus memiliki izin Identity and Access Management (IAM) tertentu, yang dijelaskan di bagian berikut. Pastikan izin ini ditambahkan ke peran IAM kustom.

Atau, Anda dapat memberikan peran IAM bawaan Admin Setelan Gemini untuk Google Cloud (roles/cloudaicompanion.settingsAdmin), yang mencakup semua izin yang diperlukan untuk semua setelan administrator Gemini untuk Google Cloud Google Cloud .

Mengonfigurasi berbagi perintah dan respons Gemini Cloud Assist

Bagian berikut memberikan langkah-langkah yang diperlukan untuk mengonfigurasi Gemini Cloud Assist agar membagikan perintah dan respons organisasi Anda kepada Google untuk peningkatan kualitas produk. Setelan ini menginstruksikan Google untuk memproses perintah dan respons semua pengguna Gemini Cloud Assist dalam project untuk tujuan peningkatan kualitas produk, yang membantu Google meningkatkan kualitas Gemini Cloud Assist.

Secara default, Google tidak memeriksa perintah yang diketik dan dikirim pengguna Anda ke Gemini Cloud Assist atau respons yang dikirim kembali. Hal ini membatasi kemampuan Google untuk meningkatkan Gemini Cloud Assist dengan lebih memahami topik yang penting bagi organisasi Anda dan seberapa baik respons kami. Jika Anda mengaktifkan berbagi perintah dan respons untuk project, Google akan menyimpan perintah dan respons anonim yang dikirimkan dari project tersebut selama maksimal dua tahun. Perintah dan respons organisasi Anda tidak pernah digunakan untuk melatih atau menyempurnakan model LLM apa pun.

Jika Anda mengaktifkan berbagi perintah dan respons dengan Google, Anda dapat menonaktifkannya kapan saja dengan membuka halaman Admin untuk Gemini di konsol Google Cloud .

Mengaktifkan berbagi perintah dan respons untuk Gemini Cloud Assist

Pilih salah satu opsi berikut:

Konsol

  1. Pastikan Anda memiliki izin Identity and Access Management (IAM) berikut di project yang memiliki langganan:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

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

    Buka Gemini untuk Google Cloud

    Halaman Gemini untuk Google Cloud akan dimuat.

  3. Klik Setelan di menu navigasi kiri.

    Halaman Setelan akan dimuat.

  4. Klik Aktifkan berbagi data untuk membagikan perintah dan respons ke Google bagi semua pengguna Gemini Cloud Assist dalam project.

API

Untuk mengaktifkan berbagi data untuk Gemini Cloud Assist, gunakan metode CreateDataSharingWithGoogleSetting.

  1. Pastikan Anda memiliki izin Identity and Access Management (IAM) berikut di project yang memiliki langganan:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. 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.

  3. 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 harus 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. Pastikan Anda memiliki izin Identity and Access Management (IAM) berikut di project tempat Anda ingin mengubah setelan:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsDelete
    • settingBindings.dataSharingWithGoogleSettingsUse

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

    Buka Gemini untuk Google Cloud

    Halaman Gemini untuk Google Cloud akan dimuat.

  3. Klik Setelan di menu navigasi kiri.

    Halaman Setelan akan dimuat.

  4. Klik Nonaktifkan berbagi data untuk berhenti membagikan perintah dan respons dengan Google bagi semua pengguna Gemini Cloud Assist dalam project.

API

Untuk menonaktifkan berbagi data untuk Gemini Cloud Assist, gunakan metode DeleteDataSharingWithGoogleSetting.

  1. Pastikan Anda memiliki izin Identity and Access Management (IAM) berikut di project tempat Anda ingin mengubah setelan:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.delete
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. Menonaktifkan berbagi perintah dan respons untuk setelan yang ditentukan:

    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