Mengonfigurasi perlengkapan otomatis lanjutan

Halaman ini menjelaskan fitur pelengkapan otomatis lanjutan Gemini Enterprise.

Sama seperti pelengkapan otomatis dasar, pelengkapan otomatis lanjutan menghasilkan saran kueri berdasarkan beberapa karakter pertama yang dimasukkan untuk kueri.

Sebelum membaca halaman ini, pahami pelengkapan otomatis dasar Gemini Enterprise. Lihat Mengonfigurasi pelengkapan otomatis.

Fitur utama pelengkapan otomatis lanjutan

Fitur utama pelengkapan otomatis lanjutan yang membedakannya dari pelengkapan otomatis dasar adalah sebagai berikut:

• Penelusuran gabungan: Pelengkapan otomatis lanjutan dapat digunakan dengan aplikasi yang terhubung ke lebih dari satu penyimpanan data.

• Kontrol akses: Pelengkapan otomatis lanjutan mematuhi kontrol akses. (Kontrol akses juga disebut sebagai ACL, daftar kontrol akses.) Pelengkapan otomatis lanjutan hanya menyarankan kueri penelusuran yang terkait dengan dokumen yang dapat diakses oleh penelusur. Untuk mengetahui informasi tentang kontrol akses, lihat Identitas dan izin.

• Penguatan bahasa: Pelengkapan otomatis lanjutan dapat ditetapkan untuk memperkuat saran dalam satu atau beberapa bahasa. Misalnya, jika bahasa browser adalah bahasa Belanda, saran pelengkapan otomatis dalam bahasa tersebut dapat ditingkatkan. Untuk mengetahui informasi selengkapnya, lihat Mengirim permintaan pelengkapan otomatis dengan penguatan bahasa.

• Berbagai jenis saran: Dengan pelengkapan otomatis lanjutan, Anda dapat menentukan bahwa Anda menginginkan berbagai jenis saran, bukan saran kueri pelengkapan otomatis biasa:

  • Saran lengkap: Sebagai saran pelengkapan otomatis, pengguna mendapatkan informasi tentang dokumen yang judulnya cocok dengan awalan huruf yang mereka ketik. Untuk mengetahui informasi selengkapnya, lihat Mengirim permintaan pelengkapan otomatis dan menampilkan saran lengkap.

  • Kueri terbaru: Sebagai saran pelengkapan otomatis, pengguna mendapatkan kueri terbaru mereka yang cocok dengan awalan huruf yang mereka ketik. Untuk mengetahui informasi selengkapnya, lihat Mengirim permintaan pelengkapan otomatis dan menampilkan kueri terbaru.

Sebelum memulai

Sebelum Anda mulai menggunakan pelengkapan otomatis lanjutan, lakukan hal berikut:

• Tinjau dan edit setelan pelengkapan otomatis untuk aplikasi Anda jika perlu. Lihat Memperbarui setelan pelengkapan otomatis.

• Untuk penyimpanan data yang lebih kecil, tetapkan Enable autocomplete ke Now. Kami merekomendasikan hal ini karena penyimpanan data kecil mungkin tidak berisi data yang cukup untuk memberikan saran yang akurat.

• Jika penyimpanan data Anda berisi informasi identitas pribadi (PII) atau jika Anda menggunakan model saran kueri histori penelusuran atau peristiwa pengguna, tinjau Melindungi dari kebocoran PII dan siapkan perlindungan pencegahan kebocoran data (DLP) yang mungkin diperlukan untuk mencegah kebocoran PII.

• Jika Anda berencana menggunakan saran penelusuran terbaru (RECENT_SEARCH), pastikan Anda mencatat peristiwa pengguna penelusuran. Gemini Enterprise tidak otomatis mengisi indeks penelusuran terbaru saat penelusuran dilakukan menggunakan metode SearchService.Search. Untuk menampilkan kueri terbaru, Anda harus mencatat peristiwa pengguna penelusuran menggunakan metode userEvents.write. Lihat Sebelum memulai kueri terbaru.

Mengirim permintaan pelengkapan otomatis

Berikut ini cara mengirim permintaan pelengkapan otomatis lanjutan menggunakan metode completionConfig.completeQuery.

REST

Untuk mengirim permintaan pelengkapan otomatis menggunakan API, ikuti langkah-langkah berikut:

1. Temukan ID aplikasi Anda. Jika Anda sudah memiliki ID aplikasi, lanjutkan ke langkah berikutnya.

   1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

      Buka Aplikasi

   2. Di halaman Apps, temukan nama aplikasi Anda dan dapatkan ID aplikasi dari kolom ID.

2. Panggil metode completionConfig.completeQuery.

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
   -d '{
         "query":"QUERY_STRING"
       }'
   

   Ganti kode berikut:

   • PROJECT_ID: ID project Anda.

   • APP_ID: ID aplikasi.

   • QUERY_STRING: input pelengkapan otomatis yang digunakan untuk mengambil saran.

Mengirim permintaan pelengkapan otomatis dengan penguatan bahasa

Anda dapat meningkatkan atau menurunkan saran pelengkapan otomatis sesuai dengan kode bahasa, misalnya, membuat saran pelengkapan otomatis dalam beberapa bahasa lebih mungkin atau kurang mungkin muncul.

Nilai penguatan harus antara -1 dan 1. Menetapkan angka negatif akan "menyembunyikan" saran pelengkapan otomatis dalam bahasa tersebut dan angka positif akan meningkatkan bahasa tersebut.

Gunakan tag bahasa dua huruf yang ditentukan oleh BCP 47—misalnya, en, fr, hi, dan zh.

REST

Untuk mengirim permintaan pelengkapan otomatis yang menyertakan nilai penguatan bahasa, ikuti langkah-langkah berikut:

1. Temukan ID aplikasi Anda. Jika Anda sudah memiliki ID aplikasi, lanjutkan ke langkah berikutnya.

   1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

      Buka Aplikasi

   2. Di halaman Apps, temukan nama aplikasi Anda dan dapatkan ID aplikasi dari kolom ID.

2. Panggil metode completionConfig.completeQuery.

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
   -d '{
         "query":"QUERY_STRING",
         "boostSpec": {
            "conditionBoostSpecs": [{
              "condition": "(langCode: ANY(LANG_CODE))",
              "boost": BOOST_VALUE
            }]
         }
       }'
   
   

   Ganti kode berikut:

   • PROJECT_ID: ID project Anda.

   • APP_ID: ID aplikasi.

   • QUERY_STRING: input pelengkapan otomatis yang digunakan untuk mengambil saran.

   • LANG_CODE: kode dua huruf untuk satu atau beberapa bahasa, dalam tanda kutip yang di-escape. Misalnya, \"fr\", \"es\" untuk menerapkan nilai penguatan ke bahasa Spanyol dan Prancis.

   • BOOST_VALUE: bilangan floating point antara -1 dan 1. Jika nilainya negatif, saran otomatis dalam bahasa tersebut akan didemosi (saran tersebut akan muncul lebih rendah dalam daftar saran). Jika nilainya positif, saran akan dipromosikan (muncul lebih tinggi dalam daftar).

   Contoh perintah

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/completionConfig:completeQuery" \
   -d '{
        "query": "hol",
        "boostSpec": {
           "conditionBoostSpecs": [{
             "condition": "(langCode: ANY(\"es\", \"fr\"))",
             "boost": 0.75 }, {
             "condition": "(langCode: ANY(\"en\"))",
             "boost": -1
           }]
         }
       }'
    

   Dalam contoh ini, saran pelengkapan otomatis untuk kueri Co ditingkatkan (ditempatkan lebih tinggi dalam daftar saran otomatis) jika dalam bahasa Prancis atau Spanyol dan diturunkan (ditempatkan lebih rendah dalam daftar saran otomatis) jika dalam bahasa Inggris.

Mengirim permintaan pelengkapan otomatis dan menampilkan saran lengkap

Pelengkapan otomatis lengkap menampilkan konten (dokumen) yang judulnya berisi kata-kata yang diawali dengan kueri.

Selain judul dokumen, permintaan pelengkapan otomatis menampilkan source_type dan entity_type, serta, jika tersedia, properti utama: uri, create_time, dan update_time. Anda dapat melihat dan mengedit pemetaan properti utama di tab Schema pada halaman penyimpanan data.

Seperti semua saran pelengkapan otomatis lanjutan, ACL dipatuhi untuk setiap dokumen yang disarankan.

Contoh

Seorang karyawan mengkueri situs intranet perusahaannya untuk mencari informasi teknis tentang izin akses.

Karyawan mulai mengetik tec, dan dokumen berikut mungkin ditampilkan: Data technicians handbook, Access technology guide, dan Techniques for troubleshooting access issues.

Dengan saran lengkap, untuk setiap dokumen yang disarankan ini, Anda dapat menampilkan informasi berikut tentang dokumen:

• judul dokumen (title), link ke dokumen (uri)

• kapan terakhir kali diperbarui (update_time)

• sumber (source_type), misalnya, apakah dokumen ditemukan di Confluence Cloud atau Slack.

Mengetahui seberapa baru dokumen diperbarui dan sumber dokumen membantu karyawan memilih dokumen mana yang akan dilihat terlebih dahulu.

Batasan

Pelengkapan otomatis lengkap hanya berlaku untuk konektor pihak ketiga dan hanya untuk penyimpanan data entity tertentu untuk konektor pihak ketiga tersebut. Tabel berikut menunjukkan entitas yang didukung untuk konektor tertentu.

Konektor pihak ketiga	Entitas yang didukung
Box	File
Confluence Cloud	Halaman	Spasi
Dropbox	File
Jira Cloud	Masalah	Spasi
OneDrive	File
Salesforce	Akun	Prospek	Peluang
ServiceNow	Insiden	Knowledge
SharePoint Online	Lampiran	Acara	File	Halaman
Slack	Pesan

Prosedur

Untuk mengirim permintaan pelengkapan otomatis yang menampilkan saran lengkap, ikuti langkah-langkah berikut:

REST

1. Temukan ID aplikasi Anda. Jika Anda sudah memiliki ID aplikasi, lanjutkan ke langkah berikutnya.

   1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

      Buka Aplikasi

   2. Di halaman Apps, temukan nama aplikasi Anda dan dapatkan ID aplikasi dari kolom ID.

2. Panggil metode completionConfig.completeQuery.

   
   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
   -d '{
         "query":"QUERY_STRING",
         "suggestionTypes": ["CONTENT"]
       }'
   
   

   Ganti kode berikut:

   • PROJECT_ID: ID project Anda.

   • APP_ID: ID aplikasi.

   • QUERY_STRING: input pelengkapan otomatis yang digunakan untuk mengambil saran.

   Contoh perintah dan hasil

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/1234/locations/global/collections/default_collection/engines/my_app/completionConfig:completeQuery" \
   - d {
         "query": "C",
         "suggestionTypes": ["CONTENT"]
       }'
   
   {
     "contentSuggestions": [{
       "suggestion": "critical crash in payment module",
       "document": {
         "name": "projects/1234/locations/global/collections/default_collection/dataStores/my_data_store/branches/0/documents/10000",
         "derivedStructData": {
           "title": "Critical Crash in Payment Module",
           "uri": "https://cymballabs.atlassian.net/browse/CPT-1",
           "source_type": "jira",
           "entity_type": "issue"
         }
       },
       "dataStore": "projects/1234/locations/global/collections/default_collection/dataStores/my_data_store"
     }]
   }
   
   

Catatan: Jika Anda menentukan suggestionTypes sebagai CONTENT, parameter boostSpec, queryModel, atau includeTailSuggestions dalam perintah curl Anda akan diabaikan.

Mengirim permintaan pelengkapan otomatis dan menampilkan kueri terbaru

Menampilkan, sebagai saran, daftar kueri terbaru pengguna yang cocok dengan awalan kueri dalam permintaan.

Saran kueri yang cocok dicantumkan dari yang terbaru hingga yang terlama. Untuk menggunakan penelusuran terbaru, ID pseudo pengguna harus diberikan.

Penting: Gemini Enterprise tidak otomatis mencatat kueri penelusuran yang dijalankan menggunakan metode SearchService.Search ke dalam histori penelusuran terbaru pengguna. Untuk menampilkan kueri terbaru, Anda harus mencatat peristiwa pengguna penelusuran. Untuk mengetahui detailnya, lihat Sebelum memulai.

Sebelum memulai

Sebelum dapat mengambil kueri terbaru dengan pelengkapan otomatis, Anda harus mencatat penelusuran pengguna sebagai peristiwa pengguna penelusuran dengan memanggil metode userEvents.write.

Jika peristiwa pengguna penelusuran tidak ditulis, permintaan ke completionConfig.completeQuery dengan suggestionTypes: ["RECENT_SEARCH"] akan menampilkan daftar saran kosong ({}).

Untuk mencatat peristiwa pengguna penelusuran, kirim permintaan POST ke metode userEvents.write dengan nilai berikut:

• eventType: tetapkan ke "search"
• userPseudoId: ditetapkan ke ID pseudonim unik pengguna
• engine: ditetapkan ke nama resource mesin Anda
• searchInfo.searchQuery: ditetapkan ke string kueri penelusuran yang dimasukkan oleh pengguna

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userEvents:write" \
  -d '{
        "eventType": "search",
        "userPseudoId": "USER_PSEUDO_ID",
        "engine": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID",
        "searchInfo": {
          "searchQuery": "SEARCH_QUERY"
        }
      }'

Ganti kode berikut:

• PROJECT_ID: ID project Anda.
• LOCATION: lokasi aplikasi atau penyimpanan data Anda (misalnya, global atau us).
• APP_ID: ID aplikasi.
• USER_PSEUDO_ID: ID pseudonim pengguna. ID ini harus cocok dengan userPseudoId yang diteruskan dalam permintaan completionConfig.completeQuery berikutnya.
• SEARCH_QUERY: string kueri yang ditelusuri oleh pengguna.

Untuk mengetahui informasi selengkapnya, lihat Mencatat peristiwa pengguna real-time dengan metode userEvents.write.

Contoh

Seorang karyawan mengkueri situs intranet perusahaannya untuk mendapatkan informasi tentang mengambil liburan. Karyawan tersebut telah melakukan kueri berikut, yang tercantum dari yang terbaru hingga yang terlama:

PTO, Vacation blackout periods, How much vacation time do I have?, Time off, Vacation policy, covering a vacant position during absences, dan Can I take unpaid time off?.

Sekarang, sebagai respons terhadap karyawan yang mengetik vac di kotak penelusuran, saran pelengkapan otomatis akan menjadi seperti berikut:

• Vacation blackout periods
• How much vacation time do I have?
• Vacation policy
• Covering a vacant position during absences

Prosedur

Untuk mengirim permintaan pelengkapan otomatis yang menampilkan kueri terbaru pengguna, ikuti langkah-langkah berikut:

REST

1. Temukan ID aplikasi Anda. Jika Anda sudah memiliki ID aplikasi, lanjutkan ke langkah berikutnya.

   1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

      Buka Aplikasi

   2. Di halaman Apps, temukan nama aplikasi Anda dan dapatkan ID aplikasi dari kolom ID.

2. Panggil metode completionConfig.completeQuery.

   
   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
   -d '{
         "query":"QUERY_STRING",
         "suggestionTypes": ["RECENT_SEARCH"],
         "userPseudoId": "USER_PSEUDO_ID"
       }'
   
   

   Ganti kode berikut:

   • PROJECT_ID: ID project Anda.

   • APP_ID: ID aplikasi.

   • QUERY_STRING: input pelengkapan otomatis yang digunakan untuk mengambil saran.

   • USER_PSEUDO_ID: ID pseudonim pengguna. Anda dapat menggunakan cookie HTTP untuk kolom ini, yang secara unik mengidentifikasi pengunjung di satu perangkat. Jangan tetapkan kolom ini ke ID yang sama untuk beberapa pengguna. Tindakan ini akan menggabungkan histori kueri mereka. Jangan sertakan informasi identitas pribadi (PII) di kolom ini.

   Contoh perintah dan hasil

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/completionConfig:completeQuery" \
   -d '{
         "query": "hol",
         "suggestionTypes": ["RECENT_SEARCH"],
         "userPseudoId": "test_user"
       }'
   
   {
     "recentSearchSuggestions": [
       {
         "suggestion": "holiday readiness",
         "recentSearchTime": "2025-05-19T18:27:07.261698Z"
       },
       {
         "suggestion": "holiday freeze",
         "recentSearchTime": "2025-05-19T18:25:45.744021Z"
       },
       {
         "suggestion": "holiday",
         "recentSearchTime": "2025-05-19T18:20:08.916884Z"
       }
     ]
   }
   

Catatan: Jika Anda menentukan suggestionTypes sebagai RECENT_SEARCH, parameter boostSpec, queryModel, atau includeTailSuggestions dalam perintah curl Anda akan diabaikan.

Menggunakan daftar penolakan pelengkapan otomatis

Anda dapat menggunakan daftar tolak untuk mencegah istilah tertentu muncul sebagai saran pelengkapan otomatis.

Meskipun pelengkapan otomatis lanjutan berada di tingkat aplikasi, daftar penolakan berada di tingkat penyimpanan data. Hal ini penting jika aplikasi Anda adalah aplikasi penelusuran gabungan. Buat daftar penolakan untuk setiap penyimpanan data yang terhubung ke aplikasi.

Untuk mengetahui informasi tentang cara membuat dan menggunakan daftar penolakan, lihat Menggunakan daftar penolakan pelengkapan otomatis.

Menggunakan daftar saran pelengkapan otomatis yang diimpor

Anda dapat memilih untuk memberikan daftar saran pelengkapan otomatis Anda sendiri, bukan menggunakan saran pelengkapan otomatis yang dihasilkan dari model data pelengkapan otomatis.

Untuk mengetahui informasi tentang cara mengimpor daftar, lihat Menggunakan daftar saran pelengkapan otomatis yang diimpor.