Halaman ini diterjemahkan oleh Cloud Translation API.

Mengonfigurasi pelengkapan otomatis lanjutan

Halaman ini menjelaskan fitur pelengkapan otomatis lanjutan Vertex AI Search.

Dengan cara yang sama seperti pelengkapan otomatis dasar, pelengkapan otomatis lanjutan menghasilkan sugesti kueri berdasarkan beberapa karakter pertama yang dimasukkan untuk kueri.

Sebelum membaca halaman ini, pahami pelengkapan otomatis dasar Vertex AI Search. Lihat Mengonfigurasi pelengkapan otomatis.

Fitur utama pelengkapan otomatis lanjutan

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

Penelusuran gabungan: Pelengkapan otomatis lanjutan dapat digunakan dengan aplikasi penelusuran gabungan, yaitu aplikasi penelusuran umum yang terhubung ke lebih dari satu penyimpanan data.
Kontrol akses: Autocomplete lanjutan mematuhi kontrol akses. (Kontrol akses juga disebut ACL, daftar kontrol akses.) Autocomplete lanjutan hanya menyarankan penelusuran yang terkait dengan dokumen yang diakses penelusur. Untuk informasi tentang kontrol akses, lihat Menggunakan kontrol akses sumber data.
Peningkatan bahasa: Isi otomatis lanjutan dapat disetel untuk meningkatkan saran dalam satu atau beberapa bahasa. Misalnya, jika bahasa browser adalah Belanda, saran pelengkapan otomatis dalam bahasa tersebut dapat ditingkatkan. Untuk mengetahui informasi selengkapnya, lihat Mengirim permintaan pelengkapan otomatis dengan peningkatan bahasa.
Berbagai jenis saran: Dengan pelengkapan otomatis lanjutan, Anda dapat menentukan bahwa Anda menginginkan berbagai jenis saran, bukan saran kueri pelengkapan otomatis reguler:
- Saran lengkap: Sebagai saran pelengkapan otomatis, pengguna mendapatkan informasi tentang dokumen yang memiliki awalan judul yang cocok dengan huruf yang mereka ketik. Untuk mengetahui informasi selengkapnya, lihat Mengirim permintaan pelengkapan otomatis dan menampilkan sugesti 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

Tinjau dan edit setelan pelengkapan otomatis untuk aplikasi Anda secara opsional. Lihat Memperbarui setelan pelengkapan otomatis.

Khusus saat melakukan pengujian, untuk penyimpanan data yang lebih kecil, sebaiknya tetapkan Aktifkan pelengkapan otomatis ke Sekarang. Hal ini karena penyimpanan data kecil mungkin tidak berisi data yang memadai untuk memberikan saran yang akurat.

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:

Temukan ID aplikasi Anda. Jika Anda sudah memiliki ID aplikasi, lanjutkan ke langkah berikutnya.
1. Di konsol Google Cloud, buka halaman Agent Builder.
  
  Buka Aplikasi
2. Di halaman Aplikasi, temukan nama aplikasi Anda dan dapatkan ID aplikasi dari kolom ID.

Panggil metode completionConfig.completeQuery.

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

PROJECT_ID: ID project Google Cloud Anda.
APP_ID: ID aplikasi Vertex AI Search.
QUERY_STRING: input typeahead yang digunakan untuk mengambil saran.

Mengirim permintaan pelengkapan otomatis dengan peningkatan bahasa

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

Nilai peningkatan 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 peningkatan bahasa, ikuti langkah-langkah berikut:

Temukan ID aplikasi Anda. Jika Anda sudah memiliki ID aplikasi, lanjutkan ke langkah berikutnya.
1. Di konsol Google Cloud, buka halaman Agent Builder.
  
  Buka Aplikasi
2. Di halaman Aplikasi, temukan nama aplikasi Anda dan dapatkan ID aplikasi dari kolom ID.

Panggil metode completionConfig.completeQuery.

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1beta/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
         }]
      }
    }'

PROJECT_ID: ID project Google Cloud Anda.
APP_ID: ID aplikasi Vertex AI Search.
QUERY_STRING: input typeahead yang digunakan untuk mengambil saran.
LANG_CODE: kode dua huruf untuk satu atau beberapa bahasa, dalam tanda petik yang di-escape. Misalnya, \"fr\", \"es\" untuk menerapkan nilai peningkatan ke bahasa Spanyol dan Prancis.
BOOST_VALUE: bilangan floating point antara -1 dan 1. Jika nilainya negatif, saran otomatis dalam bahasa akan diturunkan (saran 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": { "text": "Co"}
     "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 akan dioptimalkan (ditempatkan lebih tinggi dalam daftar saran otomatis) jika dalam bahasa Prancis atau Spanyol dan disembunyikan (ditempatkan lebih rendah dalam daftar saran otomatis) jika dalam bahasa Inggris.

Mengirim permintaan pelengkapan otomatis dan menampilkan saran lengkap

Pelengkapan otomatis yang kaya menampilkan konten (dokumen) dengan judul yang berisi kata-kata yang diawali dengan kueri.

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

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

Contoh

Seorang karyawan membuat kueri 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 yang lengkap, untuk setiap dokumen yang disarankan ini, Anda dapat menampilkan semua informasi berikut tentang dokumen: judul dokumen (title), link ke dokumen (uri), kapan dokumen terakhir diperbarui (update_time), dan sumber (source_type), misalnya, apakah dokumen ditemukan di Confluence Cloud atau Slack. Mengetahui kapan terakhir kali dokumen diperbarui dan sumber dokumen akan membantu karyawan memilih dokumen mana yang akan dilihat terlebih dahulu.

Batasan

Autocomplete lengkap hanya berlaku untuk konektor pihak ketiga dan hanya untuk penyimpanan data entitas tertentu untuk konektor pihak ketiga tersebut. Tabel berikut menunjukkan entitas yang didukung untuk konektor mana.

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

Temukan ID aplikasi Anda. Jika Anda sudah memiliki ID aplikasi, lanjutkan ke langkah berikutnya.
1. Di konsol Google Cloud, buka halaman Agent Builder.
  
  Buka Aplikasi
2. Di halaman Aplikasi, temukan nama aplikasi Anda dan dapatkan ID aplikasi dari kolom ID.

Panggil metode completionConfig.completeQuery.


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

PROJECT_ID: ID project Google Cloud Anda.
APP_ID: ID aplikasi Vertex AI Search.
QUERY_STRING: input typeahead 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/v1beta/projects/my-project-123/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/123456/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/123456/locations/global/collections/default_collection/dataStores/my-data-store"
  }]
}

Mengirim permintaan pelengkapan otomatis dan menampilkan kueri terbaru

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

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

Contoh

Seorang karyawan membuat kueri situs intranet perusahaannya untuk mendapatkan informasi tentang mengambil cuti. Karyawan telah melakukan kueri berikut, yang tercantum dari terbaru ke 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 atas karyawan yang mengetik vac di kotak penelusuran, saran pelengkapan otomatis akan menjadi sebagai 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

Temukan ID aplikasi Anda. Jika Anda sudah memiliki ID aplikasi, lanjutkan ke langkah berikutnya.
1. Di konsol Google Cloud, buka halaman Agent Builder.
  
  Buka Aplikasi
2. Di halaman Aplikasi, temukan nama aplikasi Anda dan dapatkan ID aplikasi dari kolom ID.

Panggil metode completionConfig.completeQuery.


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

PROJECT_ID: ID project Google Cloud Anda.
APP_ID: ID aplikasi Vertex AI Search.
QUERY_STRING: input typeahead yang digunakan untuk mengambil saran.
USER_PSEUDO_ID: ID pseudonim pengguna. Anda dapat menggunakan cookie HTTP untuk kolom ini, yang mengidentifikasi pengunjung secara unik 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/v1beta/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": "2024-11-19T18:27:07.261698Z"
    },
    {
      "suggestion": "holiday freeze",
      "recentSearchTime": "2024-11-19T18:25:45.744021Z"
    },
    {
      "suggestion": "holiday",
      "recentSearchTime": "2024-11-19T18:20:08.916884Z"
    }
  ]
}

Menggunakan daftar tolak pelengkapan otomatis

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

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

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