Mengimplementasikan pelengkapan otomatis

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

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

Suggest API memeriksa kueri penelusuran untuk menemukan 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” bersama genre=science fiction dan characters=Iron Man, Hulk
  • Dokumen kedua berjudul "Harry Potter" dengan genre=Adventure, Fantasy andkarakter=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, kami mengekstrak ngram (hingga trigram) “Avengers”, “Infinity”, “War”, “Avengers Infinity”, “Infinity War”, “Avengers Infinity War”. Demikian juga dari dokumen 2, kami menghasilkan "Harry", "Potter", "Harry Potter".

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

  • Anna
  • Hermione
  • Raksasa
  • 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:

  • Petualangan Hermione
  • Aksi Hermione
  • Hermione Avengers

Pelengkapan otomatis mencoba menyelesaikan kata terakhir (atau ngram) yang sedang diketik. Dalam contoh sebelumnya, karakter ini hanya memperluas "a" menjadi "petualangan", "aksi", dan "avengers" karena tidak ada teks yang dimulai dengan "hermione a" bersamaan. Saran ini disebut saran ekor; yang otomatis melengkapi kata/n-gram terakhir yang diketik.

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

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

Mengintegrasikan dengan Autocomplete API

Jika Anda menggunakan aplikasi penelusuran default atau widget penelusuran yang dapat disematkan, fitur pelengkapan otomatis Cloud Search telah didukung secara native tanpa perlu 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 melengkapi nama dan nilai properti yang sesuai secara otomatis.

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

Batasan

Pelengkapan otomatis 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 oleh pengguna sebelumnya dalam 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 maksimum 5 saran dari konten dokumen dan 2 saran orang.

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