Mengonfigurasi perujukan untuk Gemini Cloud Assist

Dokumen ini menjelaskan cara mengonfigurasi perujukan untuk Gemini Cloud Assist menggunakan konsol Google Cloud atau API.

Jenis perujukan yang tersedia meliputi:

  • Perujukan 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 Residensi Data, Transparansi Akses, dan Kunci Enkripsi yang Dikelola Pelanggan (CMEK) tidak didukung dengan opsi ini. Untuk mengetahui detail selengkapnya, lihat Perujukan dengan Google Penelusuran.

  • Grounding Web untuk Perusahaan: Memanfaatkan subkumpulan konten web yang dibatasi. Meskipun hal ini dapat menghasilkan respons berkualitas lebih rendah dibandingkan dengan Perujukan dengan Google Penelusuran, opsi ini lebih disukai untuk industri yang diatur dengan ketat (seperti sektor Keuangan, Layanan Kesehatan, dan Publik) yang memerlukan kepatuhan ketat terhadap Persyaratan Domisili Data. Untuk mengetahui detail selengkapnya, lihat Web Grounding untuk Enterprise.

Secara default, Gemini Cloud Assist menggunakan Perujukan dengan Google Penelusuran yang disediakan oleh perujukan penelusuran Vertex AI untuk meningkatkan kualitas responsnya terhadap perintah Anda. Penggunaan Perujukan dengan Google Penelusuran melibatkan penanganan data khusus untuk perintah dan respons Anda, sebagaimana dijelaskan dalam persyaratan LayananGoogle Cloud .

Sebelum memulai

  • Pastikan Google Cloud project Anda dilampirkan ke akun penagihan.

Memverifikasi izin IAM

Untuk mendapatkan izin yang diperlukan untuk 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 semua setelan administrator Gemini untuk Google Cloud .

Atau,perbarui peran IAM kustom dengan izin Identity and Access Management (IAM) tertentu, yang dijelaskan di bagian berikut.

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

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

    Buka Setelan

  3. Pilih opsi perujukan yang ingin Anda gunakan.

  4. Klik Simpan.

API

Untuk mengonfigurasi perujukan untuk Gemini Cloud Assist menggunakan API, Anda harus membuat resource geminiGcpEnablementSettings terlebih dahulu untuk menentukan jenis perujukan. Kemudian, Anda membuat resource settingBindings, yang merupakan turunan dari setelan yang Anda buat, untuk mengikat setelan ke project.

  1. Pastikan Anda memiliki izin Identity and Access Management (IAM) berikut:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • geminiGcpEnablementSettings.create
    • geminiGcpEnablementSettings.get
    • geminiGcpEnablementSettings.update
    • settingBindings.geminiGcpEnablementSettingsGet
    • settingBindings.geminiGcpEnablementSettingsUpdate
    • settingBindings.geminiGcpEnablementSettingsCreate
    • settingBindings.geminiGcpEnablementSettingsUse

  2. 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/PROJECT/locations/global/geminiGcpEnablementSettings?geminiGcpEnablementSettingId=GROUNDING_SETTING_ID"

      Ganti kode berikut:

      • PROJECT: project ID.
      • GROUNDING_TYPE: jenis perujukan, yaitu GROUNDING_WITH_GOOGLE_SEARCH atau WEB_GROUNDING_FOR_ENTERPRISE.
      • GROUNDING_SETTING_ID: nama setelan unik, seperti gt1 untuk Grounding type.

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

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

  3. Buat binding setelan:

      curl -X POST \
    -H "Authorization: Bearer $TOKEN" \
    -H 'Content-Type: application/json' \
    -d '{
      "target": "projects/PROJECT",
      "product": "GEMINI_CLOUD_ASSIST"
      }' \
    "https://cloudaicompanion.googleapis.com/v1/projects/PROJECT/locations/global/geminiGcpEnablementSettings/GROUNDING_SETTING_ID/settingBindings?settingBindingId=GROUNDING_BINDING_ID"

    Ganti kode berikut:

    • PROJECT: project ID yang akan menerapkan setelan.
    • GROUNDING_SETTING_ID: GROUNDING_SETTING_ID yang Anda tentukan saat membuat setelan.
    • GROUNDING_BINDING_ID: ID unik untuk resource pengikatan setelan, seperti b1.

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

    {
  "name": "projects/<var>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>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