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 |
Menandai kolom sebagai Perlu diperhatikan bahwa menandai kolom sebagai |
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 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
|
| Prefix matchable (Pratinjau) |
Memungkinkan kolom teks pencocokan awalan menggunakan operator 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, |
| Dapat dicocokkan sebagian (Pratinjau) |
Memungkinkan pencocokan string parsial pada kolom teks menggunakan
operator 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 |
| 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 Untuk mengetahui informasi selengkapnya, lihat Menyediakan kolom untuk telusuri saat Anda mengetik di bawah. |
Menetapkan kolom ke |
Di penyimpanan data film, Anda menetapkan kolom |
| 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:
|
| 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:
Di konsol Google Cloud , buka halaman AI Applications.
Klik nama aplikasi yang ingin Anda edit.
Klik Data.
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.
Klik Edit.
Pilih atau hapus setelan kolom yang perlu Anda perbarui. Beberapa setelan kolom tidak didukung. Misalnya, kolom numerik tidak dapat ditetapkan ke Dapat ditelusuri.
Klik Simpan untuk menerapkan perubahan.
Memberi bobot pada kolom penelusuran (Pratinjau)
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.
Jika Anda belum memiliki skema, ikuti petunjuk untuk mendapatkan skema di Melihat definisi skema.
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
summaryditetapkan ke bobot yang lebih tinggi dari normal dan kolomurike bobot yang lebih rendah. Jika Anda ingin mengembalikan bobot ke nilai default, tetapkan kedefault.Nilai yang diizinkan untuk parameter bobot adalah:
very_lowlowdefaulthighvery_high
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.
Jika Anda belum memiliki skema, ikuti petunjuk untuk mendapatkan skema di Melihat definisi skema.
Ikuti petunjuk untuk memperbarui skema secara terprogram. Tetapkan parameter yang dapat dicocokkan ke
truedalam 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
zoneditetapkan agar dapat dicocokkan dengan awalan. Hingga 12 karakter, tidak peka huruf besar/kecil, dapat digunakan dalam ekspresi filter untuk mencocokkan nilai kolom. Kolomregionditetapkan agar dapat dicocokkan sebagian.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).
Mengubah menjadi huruf kecil: Semua karakter diubah menjadi huruf kecil. Hal ini membuat pencocokan tidak peka huruf besar/kecil.
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), sepertiasia,australia, atauafrica.Awalan parsial:
STARTS_WITH("asia-south")cocok denganasia-south1-adanasia-southeast1-bkarena 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 kolomasia-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 tokenisasisupport+tier1@example.commenjadisupport,tier1,example,com,support+tier1@example.com, dansupport@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, filterCONTAINS("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 kolom25-meter, outdoor, swimming poolkarena sistem memeriksa keberadaan setiap token secara independen dari urutannya.Pencocokan alamat email: Jika kolom menyimpan email
support+tier1@example.com, filter sepertiCONTAINS("support"),CONTAINS("example.com"), atauCONTAINS("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 errorINVALID_ARGUMENTdari API saat Anda melakukan patch pada skema. saytCompatiblehanya valid pada kolom jenisstring. Menetapkan parameter ini di kolomnumber,integer,boolean,object, ataudatetimeakan menampilkan errorINVALID_ARGUMENTdari 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:
Jika Anda belum memiliki skema, ikuti petunjuk untuk mendapatkan skema di Melihat definisi skema.
Ikuti petunjuk untuk memperbarui skema secara terprogram. Tetapkan
saytCompatibleketruepada 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
titledanchannel_nameditandai sebagaisaytCompatible. MenetapkansaytCompatiblepada kolom yang jenisnya bukanstringakan menampilkan errorINVALID_ARGUMENTdari API, seperti halnya menetapkannya pada lebih dari tiga kolom dalam skema.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:
Panggil metode penelusuran pada konfigurasi penayangan Anda, seperti yang dijelaskan dalam Mendapatkan hasil penelusuran.
Dalam isi permintaan, tetapkan
searchAsYouTypeSpec.conditionkeENABLED. Tindakan ini akan mengaktifkan telusuri saat Anda mengetik pada permintaan.Opsional: Di
searchAsYouTypeSpecyang sama, persempit penelusuran saat Anda mengetik ke subset kolomsaytCompatibleskema, 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 ditandaisaytCompatible. Mereferensikan kolom yang bukansaytCompatibletidak 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 adalah1.0.scoreThreshold: dokumen yang skor telusuri saat mengetik-nya berada di bawah nilai ini akan dikecualikan. Nilai defaultnya adalah tidak ada nilai minimum.
Kirim permintaan. Contoh berikut menunjukkan bentuk
searchAsYouTypeSpecyang 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
- Memperbarui skema untuk data terstruktur
- Mengonfigurasi hasil penelusuran
- Melihat pratinjau hasil penelusuran