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.
Kueri terbaru: Dengan pelengkapan otomatis lanjutan, bukan saran kueri pelengkapan otomatis biasa, pengguna dapat mendapatkan kueri terbaru yang cocok dengan awalan huruf yang mereka ketik. Untuk 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 Google Cloud project 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 Google Cloud project 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 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 menjalankan 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 Google Cloud project 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.

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 informasi tentang cara mengimpor daftar, lihat Menggunakan daftar saran pelengkapan otomatis yang diimpor.