Mengonfigurasi perujukan untuk Gemini Cloud Assist

Dokumen ini menjelaskan cara mengonfigurasi grounding untuk Gemini Cloud Assist menggunakan Google Cloud konsol atau API. Grounding disediakan oleh Vertex AI.

Jenis grounding yang tersedia:

  • Grounding dengan Google Penelusuran (Direkomendasikan): Menginstruksikan Gemini Cloud Assist untuk menggunakan Google Penelusuran guna mendapatkan respons yang paling komprehensif dan terbaru. Perhatikan bahwa penawaran tertentu seperti Data Residency, Access Transparency, dan Customer-Managed Encryption Keys (CMEK) tidak didukung dengan opsi ini.

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

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

Sebelum memulai

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

  2. Untuk mendapatkan izin yang diperlukan guna mengonfigurasi grounding untuk Gemini Cloud Assist, minta administrator untuk memberi Anda peran Pengelolaan Identitas dan Akses (IAM) Gemini for Google Cloud Settings Admin (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 secara khusus untuk TARGET_PROJECT.

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

    • cloudaicompanion.instance.queryEffectiveSetting
    • cloudaicompanion.instance.queryEffectiveSettingBindings
    • cloudaicompanion.geminiGcpEnablementSettings.get
    • cloudaicompanion.settingBindings.geminiGcpEnablementSettingsGet
    • settingBindings.geminiGcpEnablementSettingsUpdate

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

Mengonfigurasi grounding untuk Gemini Cloud Assist

Pilih salah satu opsi berikut:

Konsol

  1. Di Google Cloud konsol, buka Gemini Cloud Assist, lalu klik Settings.

    Buka Setelan

  2. Pilih opsi grounding yang ingin Anda gunakan.

  3. Klik Save.

API

Untuk mengonfigurasi grounding untuk Gemini Cloud Assist menggunakan API, Anda membuat resource geminiGcpEnablementSettings yang menentukan jenis grounding, menggunakan metode geminiGcpEnablementSettings.create. Kemudian, Anda menerapkan setelan menggunakan metode terkait settingBindings.create 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 grounding, yaitu GROUNDING_WITH_GOOGLE_SEARCH atau WEB_GROUNDING_FOR_ENTERPRISE.
      • GROUNDING_SETTING_ID: Nama unik untuk mengidentifikasi data setelan tertentu ini, seperti gt1.

      Jika perintah 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 tempat setelan 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 binding setelan tertentu ini, seperti b1.

    Jika perintah berhasil, perintah akan menampilkan metadata operasi dalam format berikut:

    {
  "name": "projects/<var>CONTAINER_PROJECT</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</var>/locations/global/geminiGcpEnablementSettings/<var>GROUNDING_SETTING_ID</var>/settingBindings/<var>GROUNDING_BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Langkah berikutnya