Mengonfigurasi perujukan untuk Gemini Cloud Assist

Penggantian memungkinkan Anda menghubungkan Gemini Cloud Assist ke sumber web eksternal melalui Vertex AI, sehingga memberikan respons yang lebih akurat dan terbaru. Dokumen ini menjelaskan cara mengonfigurasi perujukan di konsol Google Cloud atau dengan API.

Jenis perujukan yang tersedia:

  • Grounding dengan Google Penelusuran (Direkomendasikan): Menginstruksikan Gemini Cloud Assist untuk menggunakan Google Penelusuran guna memberikan respons yang paling komprehensif dan terbaru. Perhatikan bahwa penawaran tertentu seperti Residensi Data, Transparansi Akses, dan Kunci Enkripsi yang Dikelola Pelanggan (CMEK) tidak didukung dengan opsi ini.

  • Grounding Web untuk Perusahaan: Memanfaatkan subkumpulan konten web yang dibatasi. Meskipun dapat menghasilkan respons yang berkualitas lebih rendah dibandingkan dengan Perujukan dengan Google Penelusuran, opsi ini lebih disukai untuk industri yang diatur dengan ketat yang memerlukan kepatuhan residensi data yang ketat, seperti keuangan, layanan kesehatan, dan sektor publik.

Secara default, Gemini Cloud Assist menggunakan Perujukan dengan Google Penelusuran untuk meningkatkan kualitas responsnya terhadap perintah Anda. Penggunaan fitur Perujukan dengan Google Penelusuran melibatkan penanganan data khusus untuk perintah dan respons Anda, sebagaimana dijelaskan dalam Google Cloud Persyaratan layanan.

Sebelum memulai

  1. Pastikan Google Cloud project Anda dilampirkan ke akun penagihan.

  2. Pastikan Gemini Cloud Assist telah disiapkan untuk Google Cloud project Anda.

  3. Untuk mendapatkan izin yang diperlukan guna mengonfigurasi perujukan untuk Gemini Cloud Assist, minta administrator Anda untuk memberi Anda peran IAM Admin Setelan Gemini untuk Google Cloud (roles/cloudaicompanion.settingsAdmin) di project Anda. Peran bawaan ini berisi izin yang diperlukan untuk mengelola setelan administrator Gemini Cloud Assist.

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

    Izin yang diperlukan

    • cloudaicompanion.geminiGcpEnablementSettings.create
    • cloudaicompanion.geminiGcpEnablementSettings.update
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsCreate
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsUse
      • 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.geminiGcpEnablementSettings.get
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsGet
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsUpdate

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

Mengonfigurasi perujukan 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. Pilih opsi perujukan yang ingin Anda gunakan.

  5. Klik Simpan.

API

Untuk mengonfigurasi perujukan untuk Gemini Cloud Assist menggunakan API, Anda membuat resource geminiGcpEnablementSettings yang menentukan jenis perujukan, menggunakan metode geminiGcpEnablementSettings.create. Kemudian, Anda menerapkan setelan menggunakan metode settingBindings.create terkait untuk mengikat setelan ke project.

  1. Buat setelan dan nilai khusus setelan:

    1. Dapatkan token autentikasi:

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

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

    2. Jalankan perintah berikut untuk membuat setelan:

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "webGroundingType": "GROUNDING_TYPE"
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings?geminiGcpEnablementSettingId=GROUNDING_SETTING_ID"

      Ganti kode berikut:

      • CONTAINER_PROJECT: Project ID project yang menyimpan data setelan.
      • GROUNDING_TYPE: Jenis perujukan, yaitu GROUNDING_WITH_GOOGLE_SEARCH atau WEB_GROUNDING_FOR_ENTERPRISE.
      • GROUNDING_SETTING_ID: Nama unik untuk mengidentifikasi data setelan ini, seperti gt1.

      Jika berhasil, perintah akan menampilkan isi respons yang menunjukkan webGroundingType yang ditetapkan ke pilihan Anda:

      {
  "name": "projects/CONTAINER_PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "webGroundingType": "GROUNDING_TYPE"
}

  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/geminiGcpEnablementSettings/GROUNDING_SETTING_ID/settingBindings?settingBindingId=GROUNDING_BINDING_ID"

    Ganti kode berikut:

    • TARGET_PROJECT: Project ID project yang pengaturannya harus diterapkan. Biasanya, project target dan project penampung sama.
    • CONTAINER_PROJECT: Project ID project yang menyimpan data setelan.
    • GROUNDING_SETTING_ID: GROUNDING_SETTING_ID yang Anda tentukan saat membuat setelan.
    • GROUNDING_BINDING_ID: ID unik untuk mengidentifikasi resource pengikatan setelan tertentu ini, seperti b1.

    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/geminiGcpEnablementSettings/GROUNDING_SETTING_ID/settingBindings/GROUNDING_BINDING_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Langkah berikutnya