Mengonfigurasi Gemini untuk setelan administrator Google Cloud

Dokumen ini menjelaskan cara mengakses dan menggunakan setelan Gemini untuk Google Cloud administrator guna mengonfigurasi perubahan untuk semua pengguna dalam project. Anda dapat mengelola setelan administrator untuk project menggunakan Konsol Google Cloud atau API.

Sebelum memulai

  • Pastikan project Google Cloud Anda terlampir ke akun penagihan.

Mengonfigurasi setelan untuk project dalam folder

Saat Anda mengaktifkan Gemini Cloud Assist untuk semua API dalam folder, semua setelan Gemini Cloud Assist akan dinonaktifkan secara default. Anda harus mengubah setelan untuk setiap project dalam folder.

(Opsional) Mengikat izin ke setelan dan target

Jika Anda mengonfigurasi Gemini untuk setelan administrator Google Clouddi konsol Google Cloud, Anda dapat melewati bagian ini.

Untuk mengonfigurasi Gemini untuk Google Cloud setelan administrator dengan Gemini untuk Google Cloud API, Anda harus membuat setelan terlebih dahulu, lalu membuat binding untuk "mengikat" setelan dan target tersebut (seperti instance, topik, atau project) untuk produk tertentu (seperti Gemini Cloud Assist atau Gemini Code Assist).

Semua izin untuk membuat dan memperbarui setelan berada di tingkat project.

Mengonfigurasi Gemini Cloud Assist untuk membagikan perintah dan respons dengan Google

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

Secara default, Google tidak memiliki akses untuk mencatat atau memeriksa perintah yang diketik dan dikirim oleh 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 sebuah project, Google akan menyimpan perintah dan respons anonim yang dikirimkan dari project tersebut selama maksimum 180 hari. Perintah dan respons organisasi Anda tidak pernah digunakan untuk melatih atau menyesuaikan model LLM.

Jika 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:

    • 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 sebelah kiri.

    Halaman Setelan akan dimuat.

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

Penggunaan data ini oleh Google diatur oleh Google Cloud Perjanjian, termasuk Persyaratan Penawaran Pra-GA dalam Google Cloud Persyaratan Layanan Khusus, sebagaimana dilengkapi dengan persyaratan untuk Gemini untuk Google Cloud Program Penguji Tepercaya.

API

Untuk mengaktifkan pembagian data bagi Gemini Cloud Assist, gunakan metode CreateDataSharingWithGoogleSetting.

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

    • 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:

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

    2. Tetapkan API regional:

      REGIONAL_API="cloudaicompanion.googleapis.com"

    3. Jalankan perintah berikut untuk membuat setelan:

      curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
    "enable_customer_data_sharing": true,
  } ' -X POST "https://$REGIONAL_API/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=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 yang 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
}

  3. Buat binding setelan:

      curl \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
      "target": "projects/TARGET_PROJECT_NAME"
    }' \
  -X POST \ "https://$REGIONAL_API/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings?setting_binding_id=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 dengan 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
}

Penggunaan data ini oleh Google diatur oleh Google Cloud Perjanjian, termasuk Persyaratan Penawaran Pra-GA dalam Google Cloud Persyaratan Layanan Khusus, sebagaimana dilengkapi dengan persyaratan untuk Gemini untuk Google Cloud Program Penguji Tepercaya.

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:

    • 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 sebelah kiri.

    Halaman Setelan akan dimuat.

  4. Klik Nonaktifkan berbagi data untuk berhenti membagikan perintah dan respons ke 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:

    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.delete
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

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

    1. Dapatkan token:

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

    2. Tetapkan API regional:

      REGIONAL_API="cloudaicompanion.googleapis.com"

    3. Jalankan perintah berikut untuk menonaktifkan setelan:

      curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
    "enable_customer_data_sharing": false,
  } ' -X PATCH "https://$REGIONAL_API/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=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 yang 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