Mengimplementasikan pelengkapan otomatis

Pelengkapan otomatis Cloud Search membantu pengguna dengan menyarankan kata-kata saat pengguna mengetik kueri penelusuran. Misalnya, saran dapat berupa kata-kata dari judul dokumen, operator penelusuran, nilai operator penelusuran, atau nama dan alamat email dari organisasi Google Workspace.

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

Suggest API memeriksa kueri penelusuran untuk mendapatkan petunjuk tentang bahasa kueri, seperti bahasa Inggris atau Spanyol, dan memprioritaskan hasil yang sesuai. Kolom languageCode permintaan juga digunakan untuk meningkatkan saran khusus bahasa.

Contoh skenario

Misalnya, Anda memiliki sumber data berikut yang berisi data tentang film:

  • Sumber data berisi 2 dokumen.
  • Setiap dokumen memiliki judul (ItemMetadata.title) dan dua properti: genre dan characters.
  • Dokumen pertama berjudul "Avengers Infinity War” dengan genre=science fiction dan characters=Iron Man, Hulk
  • Dokumen kedua berjudul "Harry Potter" dengan genre=Adventure, Fantasy andcharacters=Hermione, Harry Potter`

Gambar 1 mengilustrasikan cara saran pelengkapan otomatis diekstrak dari judul dokumen, properti, dan nilai properti.

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

Dari dokumen 1, kita mengekstrak ngram (hingga trigram) “Avengers”, “Infinity”, “War”, “Avengers Infinity”, “Infinity War”, “Avengers Infinity War”. Demikian pula dari dokumen 2, kita membuat “Harry”, “Potter”, “Harry Potter”.

Saat membuat kueri sumber data ini, misalnya pengguna memulai dengan mengetik "h". Saran yang ditampilkan kepada pengguna adalah:

  • Anna
  • Hermione
  • Hulk
  • Harry Potter

Misalnya, pengguna memilih saran pelengkapan otomatis “Hermione” dan tombol berikutnya dari pengguna adalah karakter "a". Saran pelengkapan otomatis yang ditampilkan kepada pengguna adalah:

  • Hermione Adventure
  • Hermione Action
  • Hermione Avengers

Pengisian otomatis mencoba melengkapi kata terakhir (atau ngram) yang diketik. Pada contoh sebelumnya, contoh ini hanya memperluas "a" menjadi "adventure", "action", dan "avengers" karena tidak ada teks yang diawali dengan "hermione a" secara bersamaan. Saran ini disebut saran akhir; hanya melengkapi otomatis kata terakhir/n-gram yang diketik.

Pelengkapan otomatis Cloud Search menampilkan maksimal 5 saran dari konten dokumen dan 2 saran orang.

Secara default, frasa dari judul dokumen ditampilkan di pelengkapan otomatis. Properti schema harus ditandai secara eksplisit sebagai is_suggestable agar API saran dapat menyelesaikan nama dan nilai properti yang sesuai secara otomatis.

Mengintegrasikan dengan Autocomplete API

Jika Anda menggunakan aplikasi penelusuran default atau widget penelusuran yang dapat disematkan, fitur pelengkapan otomatis Cloud Search didukung secara native tanpa pekerjaan tambahan. Ingat, secara default, frasa dari judul dokumen ditampilkan dalam pelengkapan otomatis. Properti skema harus ditandai secara eksplisit sebagai is_suggestable agar API saran dapat mengisi otomatis nama dan nilai properti yang sesuai.

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

Batasan

Autocomplete memiliki batasan berikut:

  • Membatasi frasa pelengkapan otomatis Cloud Search menggunakan FilterOptions yang ditentukan dalam skema tidak didukung, kecuali untuk filter bawaan berikut: objectype, mimetype, dan filter jenis.

  • Saran berbasis histori kueri (penelusuran yang dilakukan pengguna sebelumnya di aplikasi penelusuran) tidak didukung

  • Maksimum 20 properti dapat ditandai sebagai is_suggestable. Batas ini dapat ditingkatkan dengan menghubungi dukungan Cloud Search.

  • Pelengkapan otomatis operator penelusuran tidak tersedia untuk properti dengan exact_match_with_operator.

  • Pelengkapan otomatis Cloud Search menampilkan maksimal 5 saran dari konten dokumen dan 2 saran orang.

  • Pelengkapan otomatis Cloud Search hanya menyarankan frasa dari dokumen yang dapat diakses pengguna.