Apa itu kamus intervensi sinonim dan cara menggunakannya - OpenSearch

OpenSearch menyediakan kamus bawaan untuk konfigurasi sinonim otomatis. Jika kamus tersebut tidak mencakup skenario bisnis Anda atau menghasilkan kecocokan sinonim yang tidak diinginkan, buatlah kamus intervensi kustom untuk mengganti atau memperluas perilakunya.

Cara kerja kamus intervensi

Kamus intervensi memasangkan kueri pencarian dengan satu atau beberapa sinonim untuk diaktifkan atau diblokir. Ketika kueri pengguna sesuai dengan kueri yang telah ditentukan dalam suatu entri, OpenSearch menerapkan intervensi tersebut.

Jenis intervensi	Efek	Kapan digunakan
Aktifkan sinonim	OpenSearch mengembalikan hasil untuk kueri asli maupun sinonimnya.	Kamus bawaan melewatkan sinonim yang diharapkan pengguna Anda.
Blokir sinonim	OpenSearch mengecualikan hasil yang sesuai dengan sinonim tersebut.	Kamus bawaan menambahkan sinonim yang menurunkan kualitas hasil.

Entri intervensi kustom selalu memiliki prioritas lebih tinggi daripada entri kamus bawaan.

Alur kerja

Untuk menggunakan kamus intervensi dalam konfigurasi sinonim, ikuti langkah-langkah berikut secara berurutan:

Buat kamus intervensi di halaman Dictionary Management.
Tambahkan entri intervensi untuk menentukan sinonim yang akan diaktifkan atau diblokir.
Asosiasikan kamus tersebut dengan aturan analisis query pada aplikasi Anda.
Uji aturan tersebut sebelum menerapkannya ke aplikasi online.

Langkah 1: Buat kamus intervensi

Masuk ke Konsol OpenSearch. Di panel navigasi kiri, pilih Search Algorithm Center > Retrieval Configuration. Di halaman Basic Configuration, klik Dictionary Management di panel kiri.
Di halaman Dictionary Management, klik Create.
Di panel Create Query Analysis Dictionary, masukkan nama untuk kamus intervensi dan atur Dictionary Type menjadi Synonym.
Klik Save. Kamus tersebut akan muncul dalam daftar kamus.

Setelah dibuat, Anda tidak dapat mengubah nama atau jenis kamus intervensi.

Langkah 2: Tambahkan entri intervensi

Di daftar kamus, temukan kamus yang telah Anda buat dan klik Manage Entries di kolom Actions.
Di halaman Manage Entries, klik Add Intervention Entry.
Di panel Add Intervention Entries, masukkan kueri pencarian dan sinonim yang akan diaktifkan atau diblokir, lalu klik Save.
- Setiap kueri pencarian harus unik di seluruh entri dalam kamus.
- Pisahkan beberapa sinonim dengan tanda titik koma (;).

Jika suatu entri menampilkan status Validating, klik Refresh untuk mendapatkan status terbaru.

Tambahkan beberapa entri sekaligus

Untuk menambahkan beberapa entri sekaligus, gunakan format JSON berikut sesuai versi konsol Anda.

Konsol baru:

[{"cmd":"add","word":"hey","alias":["hei","hei2"],"antiAlias":["hi"]}]

Konsol lama:

[{"cmd":"add","word":"hey","alias":["hei","hei2"],"anti_alias":["hi"]}]

Bidang	Deskripsi
`cmd`	Jenis operasi. Gunakan `add` untuk menambahkan entri.
`word`	Kueri pencarian yang akan dicocokkan.
`alias`	Sinonim yang akan diaktifkan.
`antiAlias` / `anti_alias`	Sinonim yang akan diblokir.

Langkah 3: Asosiasikan kamus dengan aturan analisis query

Di halaman Query Analysis Rule Configuration, asosiasikan kamus intervensi dengan aturan analisis query.

Jangan terapkan aturan tersebut ke aplikasi online terlebih dahulu. Selesaikan Langkah 4 terlebih dahulu.

Satu kamus intervensi dapat diasosiasikan dengan beberapa aturan analisis query. Untuk menghapus kamus, lepaskan terlebih dahulu asosiasinya dari semua aturan.

Langkah 4: Uji dan terapkan

Jalankan uji pencarian untuk memastikan hasilnya sesuai harapan sebelum menerapkan aturan ke aplikasi online.

Setelah memastikan hasilnya sesuai, terapkan aturan analisis query ke aplikasi online.

Contoh: Perbaiki cakupan sinonim yang kurang

Skenario: Aplikasi panduan belanja e-commerce Anda menggunakan aturan analisis query dengan konfigurasi sinonim. Setelah diluncurkan, pencarian "apple" tidak menemukan produk relevan karena produk tersebut diindeks sebagai "apple inc."

Akar masalah: Kamus bawaan tidak mendefinisikan "apple inc." sebagai sinonim dari "apple".

Solusi: Tambahkan entri intervensi kustom apple -> apple inc.

Langkah-langkah:

Buka Search Algorithm Center > Retrieval Configuration > Dictionary Management dan klik Create. Atur Dictionary Type menjadi Synonym dan klik Save.
Temukan kamus dalam daftar dan klik Manage Entries. Klik Add Intervention Entry, masukkan apple di bidang Search Query dan apple inc. di bidang Add Synonym, lalu klik Save.
Di halaman Query Analysis Rule Configuration, asosiasikan kamus dengan aturan analisis query yang relevan. Jangan terapkan aturan tersebut ke aplikasi online terlebih dahulu.
Jalankan uji pencarian. Pastikan OpenSearch mengembalikan hasil untuk "apple" maupun "apple inc."
Terapkan aturan tersebut ke aplikasi online.

Aturan pencocokan

Memahami cara OpenSearch memilih entri intervensi mana yang berlaku membantu Anda merancang entri yang bekerja sesuai harapan.

Kondisi pemicu

Suatu entri berlaku ketika satu atau beberapa istilah semantik berurutan dalam kueri pencarian pengguna (maksimal lima istilah, tidak termasuk stop words) sesuai dengan kueri pencarian yang telah ditentukan dalam entri tersebut.

Contoh: Untuk kueri pencarian christian dior aj co-branding low-cut sneakers, jika entri-entri berikut ada:

christian dior -> dior
aj -> air jordan
co-branding -> collaboration

Ketiga entri tersebut dipicu secara bersamaan. OpenSearch memperluas kueri menjadi delapan kombinasi, seperti dior aj co-branding low-cut sneakers dan dior air jordan collaboration low-cut sneakers.

Jumlah maksimum perluasan sinonim untuk satu kueri pencarian adalah 36.

Aturan prioritas

Ketika beberapa entri dapat diterapkan pada kueri pencarian yang sama, OpenSearch menggunakan urutan prioritas berikut (dari tertinggi ke terendah):

Istilah dengan bobot lebih tinggi didahulukan. Setelah analisis query, entri untuk istilah dengan bobot lebih tinggi dipicu terlebih dahulu. Contoh: Untuk kueri which medicine is best for sphagitis low fever, setelah dianalisis, sphagitis dan medicine memiliki bobot 7, sedangkan low fever memiliki bobot 4. Entri untuk sphagitis dan medicine berlaku; entri untuk low fever tidak berlaku.
Posisi lebih awal menang jika bobot sama. Ketika dua istilah memiliki bobot yang sama, entri untuk istilah yang muncul lebih dulu dalam kueri didahulukan. Contoh: Untuk kueri apple mobile phone charger, baik apple mobile phone -> iphone maupun mobile phone charger -> power bank dapat diterapkan. Karena apple mobile phone dimulai pada posisi 1, entri apple mobile phone -> iphone berlaku.
Kueri yang telah ditentukan lebih panjang menang jika memiliki awalan yang sama. Ketika dua entri memiliki istilah awal yang sama, entri dengan lebih banyak istilah semantik didahulukan. Contoh: Untuk kueri which mobile phone charger brand is good, baik mobile phone -> cellphone maupun mobile phone charger -> power bank dapat diterapkan. Karena mobile phone charger memiliki lebih banyak istilah semantik, entri mobile phone charger -> power bank berlaku.
Entri kustom menggantikan entri bawaan. Ketika kueri yang telah ditentukan dalam entri kustom tumpang tindih dengan istilah kamus bawaan untuk kueri yang sama, hanya entri kustom yang berlaku. Contoh 1 (entri kustom mencakup istilah bawaan): Entri bawaan adalah biscuit -> cookie. Untuk kueri baked biscuit, logika bawaan memperluas menjadi baked AND (biscuit OR cookie). Jika Anda menambahkan entri kustom baked biscuit -> baked cookie, logika berubah menjadi baked biscuit OR baked cookie, dan entri bawaan diabaikan. Contoh 2 (entri kustom termasuk dalam istilah bawaan): Entri bawaan adalah apple mobile phone -> iphone. Untuk kueri apple mobile phone, logika bawaan memperluas menjadi apple mobile phone OR iphone. Jika Anda menambahkan entri kustom mobile phone -> cellphone, logika berubah menjadi apple AND (mobile phone OR cellphone).

Batasan

Sumber daya	Batas
Kamus intervensi untuk konfigurasi sinonim	20
Entri intervensi per kamus	1.000
Sinonim (diaktifkan atau diblokir) per kueri pencarian	5
Maksimum perluasan sinonim per kueri pencarian	36
Istilah semantik berurutan yang dapat memicu entri	1–5

Batasan tambahan:

Anda hanya dapat menentukan satu kueri pencarian per entri intervensi.
OpenSearch menormalisasi seluruh konten entri intervensi: huruf kapital diubah menjadi huruf kecil, dan karakter full-width diubah menjadi half-width.
Suatu entri dipicu ketika kueri pencarian yang telah ditentukan cocok dengan bagian mana pun dari kueri pengguna setelah dianalisis. Misalnya, jika kueri yang telah ditentukan adalah beijing dan pengguna mencari welcome to beijing, OpenSearch mengembalikan dokumen yang berisi "welcome to beijing" maupun "welcome to capital of china".

Catatan penggunaan

Anda tidak dapat mengubah nama atau jenis kamus intervensi setelah dibuat.
Setiap entri intervensi harus menggunakan kueri pencarian yang unik. Anda dapat menambah, menghapus, dan memodifikasi sinonim (diaktifkan atau diblokir) untuk entri yang sudah ada.
Pisahkan beberapa sinonim untuk satu kueri pencarian dengan tanda titik koma (;).
Satu kamus intervensi dapat diasosiasikan dengan beberapa aturan analisis query.
Untuk menghapus kamus, lepaskan terlebih dahulu asosiasinya dari semua aturan analisis query, baik aturan tersebut diterapkan ke aplikasi online maupun offline.
OpenSearch menggunakan kamus bawaan bersama dengan entri intervensi kustom Anda. Mengaktifkan konfigurasi sinonim pada aturan analisis query secara otomatis menyertakan kamus bawaan.

Referensi API

Untuk mendorong entri kamus intervensi secara terprogram, lihat PushInterventionDictionaryEntries.