Halaman ini diterjemahkan oleh Cloud Translation API.

Mengonfigurasi pelengkapan otomatis lanjutan

Halaman ini menjelaskan fitur pelengkapan otomatis lanjutan Aplikasi AI.

Dengan cara yang 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 Aplikasi AI. Lihat Mengonfigurasi perlengkapan 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 penelusuran gabungan, yaitu aplikasi penelusuran kustom yang terhubung ke lebih dari satu penyimpanan data.
Kontrol akses: Pelengkapan otomatis lanjutan mematuhi kontrol akses. (Kontrol akses juga disebut 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 Menggunakan kontrol akses sumber data.

Peningkatan bahasa: Pelengkapan 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, pengguna bisa mendapatkan kueri terbaru mereka yang cocok dengan awalan huruf yang mereka ketik, bukan saran kueri pelengkapan otomatis biasa. 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 Aktifkan pelengkapan otomatis ke Sekarang. 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 pengamanan pencegahan kebocoran data (DLP) yang mungkin diperlukan untuk mencegah kebocoran PII.

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 AI Applications.
  
  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/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING"
    }'

Ganti kode berikut:

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

Mengirim permintaan pelengkapan otomatis dengan peningkatan bahasa

Anda dapat meningkatkan atau menyembunyikan saran pelengkapan otomatis menurut kode bahasa, misalnya, membuat saran pelengkapan otomatis dalam beberapa bahasa lebih atau kurang mungkin muncul.

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

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 peningkat 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 AI Applications.
  
  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/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 Google Cloud project Anda.
APP_ID: ID aplikasi Vertex AI Search.
QUERY_STRING: input saran otomatis 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 peningkat ke bahasa Spanyol dan Prancis.
BOOST_VALUE: bilangan floating point antara -1 dan 1. Jika nilainya negatif, saran otomatis dalam bahasa tersebut akan diturunkan (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 ditingkatkan (ditempatkan lebih tinggi dalam daftar saran otomatis) jika dalam bahasa Prancis atau Spanyol dan dikubur (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 dalam permintaan.

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

Contoh

Seorang karyawan sedang membuat kueri situs intranet perusahaan untuk mendapatkan informasi tentang mengambil cuti. Karyawan telah melakukan kueri berikut, yang dicantumkan 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 ditampilkan 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 AI Applications.
  
  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/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 Google Cloud project Anda.
APP_ID: ID aplikasi Vertex AI Search.
QUERY_STRING: input saran otomatis yang digunakan untuk mengambil saran.
USER_PSEUDO_ID: ID pengguna yang disamarkan. 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/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"
    }
  ]
}

Menggunakan daftar penolakan pelengkapan otomatis

Anda dapat menggunakan daftar yang tidak diizinkan untuk mencegah istilah tertentu muncul sebagai saran pelengkapan otomatis.

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

Untuk mengetahui informasi tentang cara membuat dan menggunakan daftar yang ditolak, lihat Menggunakan daftar yang ditolak untuk 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.

Mengonfigurasi pelengkapan otomatis lanjutan Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Fitur utama pelengkapan otomatis lanjutan

Sebelum memulai

Mengirim permintaan pelengkapan otomatis

REST

Mengirim permintaan pelengkapan otomatis dengan peningkatan bahasa

REST

Contoh perintah

Mengirim permintaan pelengkapan otomatis dan menampilkan kueri terbaru

Contoh

Prosedur

REST

Contoh perintah dan hasil

Menggunakan daftar penolakan pelengkapan otomatis

Menggunakan daftar saran pelengkapan otomatis yang diimpor

Mengonfigurasi pelengkapan otomatis lanjutan