Mengimplementasikan pelengkapan otomatis

Pelengkapan otomatis Google Cloud Search membantu pengguna dengan menyarankan kata saat mereka mengetik kueri penelusuran. Misalnya, saran dapat mencakup kata-kata dari judul dokumen, operator penelusuran, atau nama dari organisasi Google Workspace Anda.

Pelengkapan otomatis mengekstrak frasa dari judul dokumen yang diindeks dan menggunakan model n-gram untuk menentukan saran menggunakan Suggest API. Secara default, pelengkapan otomatis menampilkan frasa dari judul dokumen. Anda juga dapat menandai properti skema teks dan enum sebagai is_suggestable untuk melengkapi otomatis nama dan nilai properti.

Suggest API memeriksa kueri penelusuran untuk mengetahui petunjuk bahasa, seperti Inggris atau Spanyol, dan memprioritaskan hasil. Kolom languageCode dalam permintaan juga meningkatkan saran khusus bahasa.

Contoh skenario

Pertimbangkan sumber data yang berisi data film:

  • Sumber data berisi dua dokumen.
  • Setiap dokumen memiliki judul (ItemMetadata.title) dan dua properti: genre dan characters.
  • Judul dokumen 1: "Avengers Infinity War"; genre=science fiction; characters=Iron Man, Hulk.
  • Judul Dokumen 2: "Harry Potter"; genre=Adventure, Fantasy; characters=Hermione, Harry Potter.

Gambar 1 mengilustrasikan cara pelengkapan otomatis mengekstrak saran.

Dua dokumen dan n-gram yang dihasilkan
Gambar 1. Dua dokumen dan n-gram yang dihasilkan digunakan untuk pelengkapan otomatis

Dari dokumen 1, model mengekstrak n-gram (hingga trigram) seperti "Avengers", "Infinity", "War", "Avengers Infinity", "Infinity War", dan "Avengers Infinity War". Dari dokumen 2, model menghasilkan "Harry", "Potter", dan "Harry Potter".

Jika pengguna mengetik "h" saat membuat kueri sumber data ini, mereka mungkin melihat saran berikut:

  • Anna
  • Hermione
  • Hulk
  • Harry Potter

Jika pengguna memilih "Hermione", lalu mengetik "a", pelengkapan otomatis dapat menampilkan:

  • Petualangan Hermione
  • Aksi Hermione
  • Hermione Avengers

Fitur pelengkapan otomatis mencoba melengkapi kata atau n-gram terakhir yang diketik. Dalam contoh ini, "a" diperluas menjadi "adventure", "action", dan "avengers" karena tidak ada teks terindeks yang dimulai dengan "hermione a". Ini adalah saran ekor.

Pelengkapan otomatis Cloud Search menampilkan maksimal lima saran dari konten dokumen dan dua saran orang.

Secara default, pelengkapan otomatis menampilkan frasa dari judul dokumen. Anda harus menandai properti skema secara eksplisit sebagai is_suggestable agar Suggest API dapat melengkapi otomatis nama dan nilai properti.

Mengintegrasikan dengan Suggest API

Jika Anda menggunakan aplikasi penelusuran default atau widget penelusuran yang dapat disematkan, Cloud Search secara native mendukung pelengkapan otomatis. Jangan lupa menandai properti skema sebagai is_suggestable jika Anda ingin properti tersebut dilengkapi otomatis.

Jika Anda membuat aplikasi penelusuran kustom, pelengkapan otomatis tersedia dengan menggunakan endpoint API /query/suggest.

Batasan

Pelengkapan otomatis memiliki batasan berikut:

  • Membatasi frasa pelengkapan otomatis menggunakan FilterOptions tidak didukung, kecuali untuk filter bawaan seperti objecttype dan mimetype.
  • Saran berdasarkan histori kueri pengguna tidak didukung.
  • Anda dapat menandai maksimum 20 properti sebagai is_suggestable. Hubungi dukungan Cloud Search untuk meningkatkan batas ini.
  • Pelengkapan otomatis operator penelusuran tidak tersedia untuk properti dengan exact_match_with_operator.
  • Pelengkapan otomatis menampilkan maksimal lima saran konten dokumen dan dua saran orang.
  • Fitur pelengkapan otomatis hanya menyarankan frasa dari dokumen yang dapat diakses pengguna.