Mengonfigurasi setelan kolom

Halaman ini menunjukkan cara mengonfigurasi kolom skema guna menyiapkan aplikasi untuk data terstruktur, data tidak terstruktur dengan metadata, atau data situs dengan atribut terstruktur kustom.

Setelan kolom membantu menentukan cara Agent Search menggunakan kolom dalam hasilnya. Anda dapat menggunakan tab Schema di konsolGoogle Cloud untuk mengonfigurasi setelan kolom.

Mengonfigurasi setelan kolom hanya tersedia untuk aplikasi dengan penyimpanan data yang berisi data terstruktur atau data tidak terstruktur dengan metadata.

Setelan kolom

Setelan kolom berikut tersedia untuk banyak jenis kolom dalam data penelusuran atau rekomendasi Anda, tetapi tidak untuk semua jenis data. Skema berisi beberapa setelan kolom untuk setiap kolom, dan tabel berikutnya berisi setelan yang dapat diterapkan ke kolom dalam skema. Penggunaan data terstruktur sangat direkomendasikan untuk setelan kolom berikut:

Setelan Definisi Tujuan Contoh kasus penggunaan
Dapat diindeks

Menetapkan kolom ke dapat diindeks memungkinkan operasi seperti pemfilteran, peningkatan, dan faset pada kolom terstruktur dalam dokumen.

Kolom jenis Object tidak dapat ditetapkan ke Indexable.

Menandai kolom sebagai Indexable memungkinkan pencarian yang lebih cepat.

Perlu diperhatikan bahwa menandai kolom sebagai Indexable akan meningkatkan ukuran indeks penelusuran dan dapat memperlambat pengindeksan.

Di penyimpanan data hotel, Anda dapat menetapkan kolom, seperti hotel_chain, sebagai dapat diindeks. Dengan demikian, Anda dapat menerapkan operasi pengurutan, pemfilteran, dan peningkatan pada hotel_chain. Misalnya, Anda dapat menerapkan filter sehingga penelusuran hanya akan menampilkan hasil penelusuran yang berisi jaringan hotel yang difilter.
Dapat ditelusuri

Kolom yang kemungkinan besar terkait dengan penelusuran ditetapkan sebagai Searchable. Kolom dapat ditelusuri tanpa dapat diindeks atau diambil.

Hanya kolom dengan nilai teks yang dapat ditandai sebagai dapat ditelusuri. Dengan demikian, kolom harga numerik dapat diindeks (untuk pemfilteran atau faset), tetapi tidak dapat ditelusuri sebagai teks lengkap.

Menetapkan kolom ke Dapat ditelusuri akan meningkatkan perolehan untuk kolom tersebut dalam kueri penelusuran, sehingga pengguna dapat menemukan konten, seperti halaman web, dengan mengkueri teks dalam kolom ini. Menandai kolom sebagai dapat ditelusuri memungkinkan penerapan peringkat. Akibatnya, menandai terlalu banyak kolom sebagai dapat ditelusuri dapat berdampak negatif pada presisi penelusuran karena membuat algoritma peringkat menjadi terlalu jenuh dan menampilkan terlalu banyak hasil. Hal ini dapat menyebabkan hasil penelusuran yang tidak relevan.

Anda dapat menerapkan pembobotan relatif ke kolom penelusuran; namun, karena default yang kuat, hal ini jarang diperlukan. Lihat Memberi bobot pada kolom penelusuran di bawah.

Sistem tiket dukungan internet service provider menyimpan setiap tiket sebagai dokumen terstruktur. Jika dokumen ini berisi kolom teks yang Dapat ditelusuri, seperti issue_description atau resolution_notes, agen dukungan dapat melakukan kueri yang terkait dengan konten di kolom tersebut, seperti cara memperbaiki kecepatan internet yang lambat setelah modem direset. Sistem kemudian akan menampilkan dokumen yang berisi salah satu istilah penelusuran tersebut, termasuk modem, internet, speed, di salah satu atau kedua kolom issue_description atau resolution_notes.

Prefix matchable
(Pratinjau)

Memungkinkan kolom teks pencocokan awalan menggunakan operator STARTS_WITH dalam ekspresi filter. Hanya kolom jenis String atau String Array yang dapat ditetapkan ke Dapat dicocokkan dengan awalan.

Untuk mengetahui informasi selengkapnya, lihat Menyediakan kolom untuk pencocokan awalan dan parsial di bawah.

Menetapkan kolom ke awalan yang dapat dicocokkan memungkinkan mesin telusur mencocokkan string kueri yang merupakan awalan dari nilai kolom. Hal ini sangat berguna untuk mencocokkan ID, jalur, atau kode hierarkis yang awal string-nya diketahui. Pencocokan awalan dibatasi hingga 12 karakter pertama dari nilai kolom yang dinormalisasi dan meningkatkan ukuran indeks penelusuran. Anda tidak dapat menetapkan lebih dari 10 kolom sebagai dapat dicocokkan dengan awalan.

Anda memiliki kolom, ticket_id, yang menggunakan format seperti <country-code><city-code><number>. Contohnya meliputi UKLON100, UKMAN100, UKMAN101, dan USNY200. Untuk menemukan semua tiket dari Manchester (UK), Anda dapat menetapkan kolom ticket_id sebagai dapat dicocokkan dengan awalan, lalu menggunakan filter ticket_id: STARTS_WITH("UKMAN"), yang menampilkan UKMAN100 dan UKMAN101.

Dapat dicocokkan sebagian
(Pratinjau)

Memungkinkan pencocokan string parsial pada kolom teks menggunakan operator CONTAINS dalam ekspresi filter. Hanya kolom jenis String atau String Array yang dapat ditetapkan ke dapat dicocokkan sebagian.

Untuk mengetahui informasi selengkapnya, lihat Menyediakan kolom untuk pencocokan awalan dan parsial di bawah.

Menetapkan kolom agar dapat dicocokkan sebagian akan mengaktifkan pencocokan berbasis token dalam kolom, sehingga pengguna dapat menemukan konten meskipun hanya sebagian nilai kolom yang diketahui. Mesin telusur mencocokkan token kueri dengan token dalam nilai kolom, terlepas dari urutannya. Perhatikan bahwa menandai kolom sebagai dapat dicocokkan sebagian akan meningkatkan ukuran indeks penelusuran. Anda tidak dapat menetapkan lebih dari 10 kolom sebagai dapat dicocokkan sebagian.

Anda ingin memfilter region di Eropa. Nama region mencakup Central Europe dan Eastern Europe. Jika filter Anda adalah region: ANY("Europe"), Anda tidak akan mendapatkan kecocokan apa pun. Namun, jika kolom region ditetapkan sebagai dapat dicocokkan sebagian, Anda dapat memfilter dengan region: CONTAINS("Europe") dan mendapatkan kecocokan untuk Central Europe dan Eastern Europe.

Kompatibel dengan telusuri saat Anda mengetik
(Pratinjau)

Menandai kolom teks sebagai dapat digunakan oleh penelusuran saat Anda mengetik: saat pengguna mengetik, dokumen akan ditampilkan jika nilai kolom berisi token yang dimulai dengan teks kueri, dan kumpulan hasil akan diberi pemeringkatan ulang pada setiap penekanan tombol.

Hanya kolom jenis String atau String Array yang dapat ditetapkan agar kompatibel dengan telusuri saat Anda mengetik. Anda tidak dapat menetapkan lebih dari tiga kolom per skema sebagai kompatibel dengan telusuri saat mengetik.

Untuk mengetahui informasi selengkapnya, lihat Menyediakan kolom untuk telusuri saat Anda mengetik di bawah.

Menetapkan kolom ke saytCompatible memungkinkan pengguna menerima kumpulan dokumen berperingkat yang diperbarui pada setiap penekanan tombol, sebelum mereka selesai mengetik kueri lengkap. Terapkan setelan ini saat Anda mengharapkan pengguna menjelajahi daftar hasil yang diperbarui saat mereka mengetik—misalnya, pencarian katalog atau navigasi longtail saat pengguna mengenali hasil yang tepat di tengah kueri, bukan mengetiknya secara lengkap. Hal ini berbeda dengan pelengkapan otomatis, yang menyarankan string kueri. Penelusuran saat mengetik menampilkan dokumen berperingkat yang cocok dengan kueri parsial.

Di penyimpanan data film, Anda menetapkan kolom title sebagai saytCompatible. Saat pengguna mengetik b, hasil penelusuran akan secara dinamis menyertakan Batman Begins, Batman Returns, dan Bats, yang diberi peringkat berdasarkan kueri pengguna. Saat pengguna memperluas kueri ke bat, tiga dokumen yang sama tetap berada dalam set hasil, yang diberi peringkat ulang untuk awalan yang lebih panjang. Memperluas kueri ke batm akan menghapus Bats karena token pertama judulnya tidak dimulai dengan batm, sehingga hanya Batman Begins dan Batman Returns yang tersisa, dan diberi pemeringkatan ulang.

Dapat difasetkan secara dinamis Menyediakan filter yang peka konteks untuk menargetkan penelusuran dengan lebih baik bagi pengguna. Menetapkan kolom sebagai Dynamic Facetable memungkinkan sistem membuat filter interaktif (aspek) secara otomatis berdasarkan nilai unik yang ada di kolom. Menetapkan kolom ke Dynamic facetable memungkinkan pengguna menyaring hasil penelusuran secara dinamis dengan memilih kategori atau atribut yang langsung berasal dari data yang Anda masukkan, tanpa harus menentukan setiap kemungkinan opsi filter secara manual. Hal ini memungkinkan pengguna mempersempit penelusuran mereka ke konten web yang sangat spesifik.
Gunakan Dynamic Facetable dengan Searchable untuk mencapai hasil yang lebih baik, yang meningkatkan perolehan penelusuran dan kualitas faset yang ditawarkan kepada pengguna.
Halaman dalam pusat informasi internal perusahaan, seperti kebijakan HR, diserap dengan data seperti department, document_type, atau last_modified_date. Jika kolom ini diberi tag sebagai dynamic facetable, penelusuran karyawan untuk istilah seperti penggantian biaya akan secara dinamis menghasilkan filter interaktif berdasarkan hasil relevan yang ditemukan. Dalam hal ini, antarmuka web dapat menampilkan faset untuk Departemen: Keuangan, Perjalanan, Jenis Dokumen: Kebijakan, FAQ, atau Tanggal Terakhir Diubah: Kuartal Ini, Tahun Lalu.
Dapat diambil Saat kueri penelusuran menemukan konten yang cocok, mesin telusur dapat menarik nilai kolom yang dapat diambil untuk ditampilkan atau digunakan dalam aplikasi, yang berarti informasi dari dokumen asli ditampilkan sebagai bagian dari hasil penelusuran. Kolom kunci (ID unik untuk dokumen) disiapkan sebagai dapat diambil. Kolom yang dapat diambil memberikan konteks penelusuran dengan membedakan kolom yang nilainya dapat ditampilkan dari kolom yang hanya akan digunakan dalam logika penelusuran, tetapi nilai mentahnya tidak dimaksudkan untuk ditampilkan kepada pengguna. Untuk penelusuran produk di situs penjual, product_id, name, price, dan image_url adalah kolom umum yang ingin Anda tetapkan sebagai dapat diambil. Di sisi lain, internal_tracking_code dapat diindeks dan difilter hanya untuk tujuan administratif, tetapi tidak dapat diambil dalam hasil penelusuran publik.
Completable Memungkinkan konten kolom digunakan untuk saran kueri penelusuran. Untuk informasi selengkapnya, lihat Mengonfigurasi pelengkapan otomatis.

Setelan ini memungkinkan nilai dalam kolom tersebut digunakan untuk memberikan saran kueri real-time saat pengguna mengetik. Fitur ini membantu memandu pengguna ke konten yang relevan dan mempercepat proses penelusuran. Faktor tertentu seperti penggunaan pemfilteran bahasa alami dapat memengaruhi performa ini.

Jika kolom completable ditetapkan untuk product_name, brand, dan category, saat pengguna mengetik Tech, saran pelengkapan otomatis dapat menampilkan:
  • TechCo (dari kolom brand)
  • TechCo UltraBook X1 (dari kolom product_name)
  • Teknologi GameMaster Pro (produk lain dari kolom category)
Dapat difilter Memungkinkan rekomendasi menggunakan kolom untuk memfilter hasil yang direkomendasikan, sehingga menentukan hasil penelusuran yang dilihat pengguna Anda. Untuk mengetahui informasi tentang cara memfilter rekomendasi, lihat Memfilter rekomendasi. Menetapkan kolom ke Filterable membantu menyesuaikan rekomendasi untuk pengguna. Perhatikan bahwa batas pemfilteran berlaku. Setelan filter menurut bahasa dan drama dapat terlihat seperti: language_code: ANY("en", "fr") OR categories: ANY("drama").

Perbedaan antara setelan yang umum digunakan

Ada perbedaan utama antara setelan kolom yang dapat diindeks, dapat ditelusuri, dan dapat diambil. Tabel ini merangkum perbedaan tersebut.

Fitur Indexable Dapat ditelusuri Dapat diambil
Peran Utama Membuat konten kolom tersedia untuk mesin telusur Memungkinkan kueri teks lengkap terhadap konten kolom Memungkinkan nilai kolom ditampilkan dalam hasil penelusuran
Analisis Konten diproses dan dimasukkan ke dalam indeks. Biasanya menjalani analisis leksikal yang ekstensif. Nilai disimpan apa adanya untuk ditampilkan.
Bisakah...
...Dapat ditelusuri? Ya (sering kali menjadi prasyarat) T/A Tidak harus (dapat diambil tanpa dapat ditelusuri)
...Dapat diambil? Belum tentu Belum tentu T/A
...Dapat difilter/Dapat diurutkan/Dapat difaset? Ya (umumnya juga merupakan prasyarat untuk hal ini) Tidak secara langsung; ini adalah atribut terpisah yang sering dibuat di kolom yang dapat diindeks. Tidak secara langsung; atribut ini berkaitan dengan cara kolom diindeks dan dikueri, bukan hanya ditampilkan.

Dalam praktiknya, banyak kolom yang penting untuk pengalaman pengguna (seperti judul, deskripsi, dan informasi identitas pribadi) sering kali ditetapkan sebagai indexable, searchable, dan retrievable.

Batasan

Setelan kolom memiliki batasan berikut:

  • Anda dapat mengonfigurasi hingga 50 kolom sebagai dapat diindeks, dapat ditelusuri, dapat diambil, atau dapat difaset secara dinamis.
  • Untuk mengonfigurasi kolom sebagai dapat difaset secara dinamis, kolom tersebut harus dikonfigurasi terlebih dahulu sebagai dapat diindeks.
  • Mengubah setelan yang dapat diindeks memerlukan pengindeksan ulang data, yang dapat memerlukan waktu berjam-jam, terutama untuk penyimpanan data yang besar.

Jika Anda mengonfigurasi kolom untuk aplikasi penelusuran media dan menginginkan informasi mendetail tentang kolom dalam skema, lihat Tentang dokumen media dan penyimpanan data.

Memperbarui setelan kolom

Untuk memperbarui setelan kolom:

  1. Di konsol Google Cloud , buka halaman AI Applications.

    AI Applications

  2. Klik nama aplikasi yang ingin Anda edit.

  3. Klik Data.

  4. Klik tab Schema. Tab ini menampilkan setelan kolom saat ini.

    Anda tidak akan melihat tab Schema jika penyimpanan data Anda berisi data situs dasar atau data tidak terstruktur tanpa metadata.

  5. Klik Edit.

  6. Pilih atau hapus setelan kolom yang perlu Anda perbarui. Beberapa setelan kolom tidak didukung. Misalnya, kolom numerik tidak dapat ditetapkan ke Dapat ditelusuri.

  7. Klik Simpan untuk menerapkan perubahan.

Jika menandai kolom sebagai dapat ditelusuri, Anda dapat menentukan bobot untuk menunjukkan kepentingan relatifnya dalam hasil penelusuran. Sebagian besar situasi tidak mengharuskan Anda menentukan bobot untuk setiap kolom karena bobot default berfungsi dengan baik.

Namun, penyesuaian bobot mungkin diperlukan dalam beberapa situasi, misalnya:

  • Anda memigrasikan data dari platform penelusuran yang sudah menggunakan kolom berbobot.

  • Jika bobot default tidak memberikan hasil penelusuran yang memuaskan. Secara khusus, hal ini dapat terjadi jika Anda memiliki banyak kolom penelusuran dan beberapa di antaranya jauh lebih penting daripada yang lain.

    Mungkin, ringkasan adalah kolom yang paling penting untuk penelusuran, sehingga Anda ingin memprioritaskan teks tersebut.

    Atau, skema memiliki kolom yang berisi kata kunci yang sangat relevan dan merupakan prediktor yang sangat baik untuk hasil penelusuran, tetapi, karena kolom ini jauh lebih pendek daripada kolom lainnya, pengaruhnya sering kali dibayangi oleh kolom yang lebih panjang. Meningkatkan bobotnya akan memastikan bahwa fitur tersebut memiliki dampak yang diinginkan.

Tingkat bobot

Bobot dikelompokkan ke dalam level berikut:

Nilai penting kolom Penjelasan
Sangat rendah Nilai rendah yang masih dipertimbangkan sistem saat menggabungkan skor dari semua kolom. Jika Anda menginginkan bobot yang lebih kecil sehingga efeknya dapat diabaikan, jangan tandai kolom sebagai dapat ditelusuri.
Rendah Bobot yang lebih rendah dari default.
Default Bobot standar untuk kolom penelusuran. Bobot ini memberikan performa yang cukup baik untuk sebagian besar kasus.
Tinggi Bobot yang jauh lebih tinggi daripada default.
Sangat tinggi Bobot yang dominan. Biasanya, Anda mencadangkan ini untuk, paling banyak, satu kolom.

Pembaruan skema dan pengindeksan ulang

Menambahkan bobot ke kolom penelusuran memerlukan pembaruan skema dan pengindeksan ulang data berikutnya di penyimpanan data. Memperbarui skema memerlukan waktu berjam-jam, dan tidak ada indikator yang dapat diandalkan untuk memberi tahu Anda kapan pengindeksan selesai, jadi Anda perlu melebih-lebihkan waktu pengindeksan.

Menetapkan tingkat bobot pada kolom

Tugas menetapkan tingkat bobot untuk kolom bisa jadi membosankan karena Anda hanya boleh membuat perubahan kecil dan meninjau hasil penelusuran dengan cermat setelahnya untuk memeriksa konsekuensi yang tidak diinginkan. Setelah setiap perubahan, Anda harus menunggu pengindeksan ulang selesai sebelum dapat mengevaluasi dampak perubahan tersebut.

Anda hanya dapat mengonfigurasi pembobotan kolom penelusuran melalui API. Fitur ini tidak tersedia di konsol Google Cloud .

Untuk menetapkan bobot, Anda perlu memperbarui skema untuk penyimpanan data melalui metode API projects.locations.dataStores.schemas.patch.

  1. Jika Anda belum memiliki skema, ikuti petunjuk untuk mendapatkan skema di Melihat definisi skema.

  2. Ikuti petunjuk untuk memperbarui skema secara terprogram. Tambahkan bobot ke satu atau beberapa kolom penelusuran, seperti dalam contoh berikut:

    "summary": {
       "type": "string",
       "searchable": true,
       "weight": "high"
     },
     "uri": {
       "type": "string",
       "searchable": true,
       "weight": "low"
     },
    

    Dalam contoh ini, kolom summary ditetapkan ke bobot yang lebih tinggi dari normal dan kolom uri ke bobot yang lebih rendah. Jika Anda ingin mengembalikan bobot ke nilai default, tetapkan ke default.

    Nilai yang diizinkan untuk parameter bobot adalah:

    • very_low
    • low
    • default
    • high
    • very_high
  3. Tunggu hingga pengindeksan ulang selesai dan uji perilaku penelusuran.

Menyediakan kolom untuk pencocokan awalan dan parsial (Pratinjau)

Untuk kolom jenis string, Anda dapat mengedit skema agar kolom tersedia untuk pencocokan awalan atau pencocokan sebagian. Hal ini memungkinkan Anda menggunakan STARTS_WITH atau CONTAINS dalam ekspresi filter.

Pembaruan skema dan pengindeksan ulang

Agar kolom tersedia untuk pencocokan awalan atau parsial, diperlukan update skema dan pengindeksan ulang data berikutnya di penyimpanan data. Memperbarui skema memerlukan waktu berjam-jam, dan tidak ada indikator yang dapat diandalkan untuk memberi tahu Anda kapan pengindeksan selesai, sehingga Anda perlu memperkirakan waktu pengindeksan secara berlebihan.

Memperbarui skema untuk pencocokan awalan dan parsial

Untuk menentukan kolom yang tersedia untuk pencocokan awalan atau pencocokan parsial, Anda perlu memperbarui skema penyimpanan data melalui metode projects.locations.dataStores.schemas.patch API.

  1. Jika Anda belum memiliki skema, ikuti petunjuk untuk mendapatkan skema di Melihat definisi skema.

  2. Ikuti petunjuk untuk memperbarui skema secara terprogram. Tetapkan parameter yang dapat dicocokkan ke true dalam skema, seperti dalam contoh berikut:

    "zone": {
       "type": "string",
       "searchable": true,
       "prefixMatchable": true
     },
     "region": {
       "type": "string",
       "searchable": true,
       "partialMatchable": true
     },
     "model": {
       "type": "string",
       "searchable": true,
       "prefixMatchable": true,
       "partialMatchable": true
     },
    

    Dalam contoh ini, kolom zone ditetapkan agar dapat dicocokkan dengan awalan. Hingga 12 karakter, tidak peka huruf besar/kecil, dapat digunakan dalam ekspresi filter untuk mencocokkan nilai kolom. Kolom region ditetapkan agar dapat dicocokkan sebagian.

  3. Tunggu hingga pengindeksan ulang selesai.

Detail tentang pencocokan awalan

Pencocokan awalan di Agent Search memungkinkan Anda memfilter hasil berdasarkan apakah nilai kolom dimulai dengan string tertentu. Kemampuan ini didukung oleh operator STARTS_WITH dan mengharuskan kolom teks target dikonfigurasi sebagai prefixMatchable dalam skema.

Logika normalisasi dan pencocokan

Untuk mengoptimalkan performa dan memastikan konsistensi, sistem menerapkan proses normalisasi tertentu ke nilai kolom (selama pengindeksan) dan string kueri (selama penelusuran).

  1. Mengubah menjadi huruf kecil: Semua karakter diubah menjadi huruf kecil. Hal ini membuat pencocokan tidak peka huruf besar/kecil.

  2. Pemotongan 12 karakter: Sistem hanya mempertimbangkan 12 karakter pertama string. Karakter apa pun di luar batas ini akan diabaikan untuk tujuan pencocokan awalan.

Cara kerjanya

Pada waktu pengindeksan, untuk kolom yang ditandai sebagai prefixMatchable, sistem akan membuat token awalan untuk 12 karakter pertama. Untuk nilai seperti asia-south1-c, indeks menyimpan token untuk a, as, asi, asia, asia-, dan seterusnya, hingga karakter ke-12 (asia-south1-).

Pada waktu kueri, string yang diberikan ke operator STARTS_WITH juga diubah menjadi huruf kecil dan dipotong menjadi 12 karakter. Kueri tersebut kemudian dicocokkan dengan token awalan yang disimpan.

Contoh

Contoh berikut menunjukkan pengaruh normalisasi 12 karakter terhadap hasil penelusuran:

  • Pencocokan luas: STARTS_WITH("A") cocok dengan nilai apa pun yang diawali dengan "a" (tidak peka huruf besar/kecil), seperti asia, australia, atau africa.

  • Awalan parsial: STARTS_WITH("asia-south") cocok dengan asia-south1-a dan asia-southeast1-b karena keduanya dimulai dengan string 10 karakter yang ditentukan.

  • Perilaku pemotongan: Karena hanya 12 karakter pertama yang dicocokkan, STARTS_WITH("asia-south1-a") cocok dengan nilai kolom asia-south1-c. Hal ini terjadi karena kedua string dinormalisasi ke awalan 12 karakter yang sama: asia-south1-.

Detail tentang pencocokan sebagian

Pencocokan parsial di Penelusuran Agen memungkinkan Anda memfilter hasil berdasarkan apakah nilai kolom berisi kata atau token tertentu. Kemampuan ini didukung oleh operator CONTAINS dan mengharuskan kolom teks target dikonfigurasi sebagai partialMatchable dalam skema.

Logika normalisasi dan tokenisasi

Penelusuran Agen menormalisasi dan mentokenisasi nilai kolom (selama pengindeksan) dan string kueri (selama penelusuran):

  • Mengubah ke huruf kecil: Agent Search mengonversi karakter menjadi huruf kecil. Hal ini membuat pencocokan tidak peka huruf besar/kecil.

  • Tokenisasi: Agent Search membagi string menjadi token (kata) individual menggunakan spasi dan karakter lain sebagai pembatas.

    • Pembatas standar: Spasi dan tanda baca umum berfungsi sebagai pembatas; ini termasuk tanda hubung (-), garis miring (/), koma (,), titik (.), tanda bintang (*), kurung kurawal ({ }), tanda kurung siku ([ ]), tanda kurung biasa (( )), dan tanda petik (').

    • Non-pembatas: Ampersan (&) dan garis bawah (_) tidak berfungsi sebagai pembatas. Sistem menganggap karakter yang digabungkan dengan simbol ini sebagai satu token.

    • Pembatas email (@): Simbol @ berfungsi sebagai pembatas khusus untuk membantu mengenali alamat email. Sistem akan menghasilkan token untuk komponen individual serta bentuk gabungan. Misalnya, tokenizer ini melakukan tokenisasi support+tier1@example.com menjadi support, tier1, example, com, support+tier1@example.com, dan support@example.com.

Cara kerjanya

Pada waktu pengindeksan, untuk kolom yang ditandai sebagai partialMatchable, sistem akan menormalisasi dan melakukan tokenisasi pada nilai kolom, lalu menyimpan token yang dihasilkan dalam indeks. Misalnya, nilai kolom 25-meter, outdoor, swimming pool akan ditokenisasi menjadi [25, meter, outdoor, swimming, pool].

Pada waktu kueri, string yang diberikan ke operator CONTAINS akan menjalani proses normalisasi dan tokenisasi yang sama. Mesin telusur kemudian memverifikasi bahwa semua token kueri yang dihasilkan cocok dengan token yang disimpan untuk kolom tersebut. Urutan token tidak berpengaruh.

Contoh

Contoh berikut menunjukkan pengaruh tokenisasi terhadap hasil pencocokan parsial:

  • Pencocokan token dasar: Jika nilai kolom adalah 25-meter, outdoor, swimming pool, filter CONTAINS("Outdoor pool") akan cocok. Sistem akan mentokenisasi kueri menjadi [outdoor, pool], yang keduanya ada dalam token kolom.

  • Kemandirian urutan: Filter CONTAINS("pool outdoor") juga cocok dengan nilai kolom 25-meter, outdoor, swimming pool karena sistem memeriksa keberadaan setiap token secara independen dari urutannya.

  • Pencocokan alamat email: Jika kolom menyimpan email support+tier1@example.com, filter seperti CONTAINS("support"), CONTAINS("example.com"), atau CONTAINS("support@example.com") semuanya berhasil dicocokkan karena tokenisasi khusus simbol @.

Menyediakan kolom untuk penelusuran saat Anda mengetik (Pratinjau)

Untuk kolom jenis string, Anda dapat mengedit skema untuk menandai kolom sebagai saytCompatible. Jika satu atau beberapa kolom pada skema adalah saytCompatible dan aplikasi Anda memilih ikut serta dalam penelusuran saat mengetik pada permintaan penelusuran, Agent Search akan menampilkan dokumen yang kolom saytCompatible-nya berisi token yang diawali dengan teks kueri dan melakukan pemeringkatan ulang dokumen tersebut pada setiap penekanan tombol.

Tentang telusuri saat Anda mengetik untuk media

Telusuri saat Anda mengetik adalah fitur yang tersedia secara umum untuk aplikasi media. Lihat Mendapatkan hasil telusuri saat Anda mengetik untuk aplikasi media untuk kolom permintaan searchAsYouTypeSpec.condition khusus media.

Setelan kolom saytCompatible memperluas penelusuran saat Anda mengetik ke aplikasi penelusuran mana pun dengan memungkinkan Anda menandai kolom skema tertentu untuk menjawab kueri parsial. Aplikasi media dapat terus menggunakan searchAsYouTypeSpec.condition seperti sebelumnya; aplikasi non-media memerlukan kolom saytCompatible pada skema.

Pelengkapan otomatis dan penelusuran saat Anda mengetik

Penelusuran saat mengetik berbeda dengan pelengkapan otomatis:

  • Pelengkapan otomatis memprediksi string kueri dan didorong oleh setelan kolom completable.
  • Search-as-you-type menampilkan dokumen yang diberi peringkat dan didorong oleh setelan kolom saytCompatible.

Kedua fitur ini dapat digunakan secara terpisah atau bersama-sama, dan tidak berbagi data.

Batas

Membuat kolom saytCompatible memiliki batasan berikut:

  • Anda tidak dapat menandai lebih dari tiga kolom per skema sebagai saytCompatible. Menetapkan yang keempat akan menampilkan error INVALID_ARGUMENT dari API saat Anda melakukan patch pada skema.
  • saytCompatible hanya valid pada kolom jenis string. Menetapkan parameter ini di kolom number, integer, boolean, object, atau datetime akan menampilkan error INVALID_ARGUMENT dari API.
  • Hanya 12 token pertama dari nilai kolom yang diindeks, dan setiap token berkontribusi pada fragmen awalan hingga 10 karakter pertamanya. Nilai yang lebih panjang tetap diindeks, tetapi bagian akhirnya tidak dapat dijangkau melalui awalan.

Pembaruan skema dan pengindeksan ulang

Menetapkan kolom sebagai saytCompatible memerlukan pembaruan skema dan pengindeksan ulang data berikutnya di penyimpanan data. Memperbarui skema memerlukan waktu berjam-jam, dan tidak ada indikator yang dapat diandalkan untuk memberi tahu Anda kapan pengindeksan selesai, jadi Anda perlu melebih-lebihkan waktu pengindeksan.

Memperbarui skema untuk penelusuran saat mengetik

Untuk menandai kolom sebagai saytCompatible menggunakan metode projects.locations.dataStores.schemas.patch, lakukan hal berikut:

  1. Jika Anda belum memiliki skema, ikuti petunjuk untuk mendapatkan skema di Melihat definisi skema.

  2. Ikuti petunjuk untuk memperbarui skema secara terprogram. Tetapkan saytCompatible ke true pada kolom yang ingin Anda aktifkan untuk fitur tersebut, seperti dalam contoh ini:

    "title": {
       "type": "string",
       "retrievable": true,
       "saytCompatible": true
     },
     "channel_name": {
       "type": "string",
       "retrievable": true,
       "saytCompatible": true
     },
    

    Dalam contoh ini, kolom title dan channel_name ditandai sebagai saytCompatible. Menetapkan saytCompatible pada kolom yang jenisnya bukan string akan menampilkan error INVALID_ARGUMENT dari API, seperti halnya menetapkannya pada lebih dari tiga kolom dalam skema.

  3. Tunggu hingga pengindeksan ulang selesai.

Mengirim permintaan penelusuran telusuri saat Anda mengetik

Setelah pengindeksan ulang selesai, pilih ikut serta dalam penelusuran saat mengetik pada setiap permintaan penelusuran dengan mengirimkan permintaan penelusuran yang isinya menyertakan searchAsYouTypeSpec. Kolom yang ditandai sebagai saytCompatible pada skema hanya akan dikonsultasikan saat searchAsYouTypeSpec ditetapkan pada permintaan, sehingga Anda dapat mempertahankan konfigurasi penyajian yang sama untuk kueri parsial dan lengkap.

Untuk mengirim permintaan penelusuran telusuri saat mengetik, lakukan hal berikut:

  1. Panggil metode penelusuran pada konfigurasi penayangan Anda, seperti yang dijelaskan dalam Mendapatkan hasil penelusuran.

  2. Dalam isi permintaan, tetapkan searchAsYouTypeSpec.condition ke ENABLED. Tindakan ini akan mengaktifkan telusuri saat Anda mengetik pada permintaan.

  3. Opsional: Di searchAsYouTypeSpec yang sama, persempit penelusuran saat Anda mengetik ke subset kolom saytCompatible skema, beri setiap kolom bobot relatif, dan tetapkan nilai minimum skor di bawah dokumen yang dihapus. Setiap nilai dalam blok ini bersifat opsional; jika dihilangkan, nilai default akan berlaku.

    • fields[i].key: kolom skema yang ditandai saytCompatible. Mereferensikan kolom yang bukan saytCompatible tidak akan menampilkan kontribusi telusuri saat Anda mengetik dari kolom tersebut.
    • fields[i].weight: tingkat kepentingan relatif kolom dalam skor telusuri saat Anda mengetik. Nilai defaultnya adalah 1.0.
    • scoreThreshold: dokumen yang skor telusuri saat mengetik-nya berada di bawah nilai ini akan dikecualikan. Nilai defaultnya adalah tidak ada nilai minimum.
  4. Kirim permintaan. Contoh berikut menunjukkan bentuk searchAsYouTypeSpec yang mengaktifkan penelusuran saat Anda mengetik, mencakupnya ke dua kolom dengan bobot berbeda, dan menetapkan skor minimum:

    "searchAsYouTypeSpec": {
      "condition": "ENABLED",
      "fields": [
        { "key": "title", "weight": 1.2 },
        { "key": "channel_name" }
      ],
      "scoreThreshold": 0.5
    }
    

Detail tentang telusuri saat Anda mengetik

Penelusuran saat Anda mengetik di Penelusuran Agen memungkinkan pengguna menerima dokumen berperingkat pada setiap penekanan tombol terhadap kolom yang ditandai sebagai saytCompatible pada skema.

Logika normalisasi dan tokenisasi

Agent Search menormalisasi dan mentokenisasi nilai kolom (selama pengindeksan) dan teks kueri (selama penelusuran):

  • Mengubah ke huruf kecil: Agent Search mengonversi karakter menjadi huruf kecil. Hal ini membuat pencocokan tidak peka huruf besar/kecil.

  • Tokenisasi: Agent Search membagi string menjadi token (kata) individual menggunakan spasi dan tanda baca umum sebagai pembatas, yang cocok dengan perilaku yang digunakan untuk pencocokan parsial.

  • Batas per kolom: hanya 12 token pertama dari nilai kolom yang diindeks untuk penelusuran saat Anda mengetik; setiap token tersebut menyumbangkan fragmen awalan hingga 10 karakter pertamanya.

Contoh

Jika kolom actor_name ditandai saytCompatible dan dokumen memiliki nilai Christian Bale, kueri chr akan menjangkau dokumen melalui fragmen awalan panjang 3 dari token christian, dan memperluas kueri ke chris masih cocok melalui fragmen awalan panjang 5. Kueri bale juga cocok, melalui fragmen awalan panjang 4 dari token kedua dalam nilai kolom. Pembaruan peringkat diterapkan pada setiap penekanan tombol saat pengguna mengetik.

Langkah berikutnya