Cara menampilkan ringkasan hasil pencarian - OpenSearch - Alibaba Cloud Documentation Center

Ringkasan hasil pencarian memungkinkan Anda mengontrol konten yang ditampilkan dalam hasil pencarian dan cara kata kunci kueri yang sesuai disorot. Alih-alih mengembalikan dokumen lengkap, OpenSearch mengekstraksi serta menampilkan segmen pendek dari konten dokumen yang berisi kueri pencarian, sehingga membantu pengguna menilai relevansi hasil tersebut.

Anda dapat mengonfigurasi ringkasan hasil pencarian melalui Konsol OpenSearch atau melalui API dan SDK:

Konsol: Pengaturan disimpan ke aplikasi dan diterapkan secara otomatis ke setiap permintaan pencarian. Anda tidak perlu mengirimkan parameter summary dalam panggilan API.
API/SDK: Kirimkan parameter summary secara langsung dalam setiap permintaan pencarian. Gunakan pendekatan ini bila Anda memerlukan kontrol per permintaan atau sedang membangun integrasi terprogram.

Parameter

Parameter	Deskripsi
Field	Bidang yang akan diekstraksi dan ditampilkan dalam ringkasan. Harus bertipe teks agar dapat dianalisis.
Segment length	Panjang maksimum ringkasan hasil pencarian.
HTML tag for highlight	Nama tag HTML yang digunakan untuk menyorot kueri pencarian dengan warna merah. Sistem membungkus nama tag tersebut dengan tanda kurung sudut dan menempatkannya di awal serta akhir setiap kecocokan. Misalnya, `em` menghasilkan `matched query`.
Segment connector	String yang digunakan untuk menghubungkan beberapa segmen. Nilai umum: `...`
Number of segments	Jumlah segmen konten yang diekstraksi dari dokumen.

Konfigurasikan ringkasan hasil pencarian di Konsol OpenSearch

Masuk ke Konsol OpenSearch. Di panel navigasi sebelah kiri, klik OpenSearch Industry Algorithm Edition, lalu pilih OpenSearch High-performance Search Edition, kemudian pilih Feature Extensions > Search Result Display.
Pada halaman Search Result Display, pilih aplikasi Anda dari daftar drop-down.
Di bagian Search Result Summary, konfigurasikan parameter untuk setiap bidang. Contoh berikut mengatur HTML Tag for Highlight menjadi em untuk bidang title.

Setelah disimpan, pengaturan konsol secara otomatis disertakan dalam klausa kueri untuk setiap permintaan API. Anda tidak perlu lagi mengirimkan parameter summary.

Konfigurasikan ringkasan hasil pencarian melalui API atau SDK

API

Kirimkan parameter summary dalam permintaan pencarian Anda. Lihat Initiate search requests untuk format parameternya.

SDK untuk Java

Gunakan kelas Summary dari SDK SearchParams untuk mengonfigurasi ringkasan. Contoh berikut mengatur semua parameter ringkasan untuk bidang name:

Summary summ = new Summary("name");
summ.setSummary_field("name");      // Bidang harus bertipe teks untuk mendukung analisis
summ.setSummary_len("50");          // Panjang maksimum segmen dalam byte
summ.setSummary_element("em");      // Nama tag HTML untuk penyorotan berwarna merah; menghasilkan ...
summ.setSummary_ellipsis("...");    // Penghubung antar segmen
summ.setSummary_snippet("1");       // Jumlah segmen yang akan diekstrak

setSummary_element() hanya mengatur nama tag. Sistem secara otomatis membungkusnya dengan tanda kurung sudut. Misalnya, mengatur em menghasilkan Alibaba CloudOpenSearchproduct document.

Untuk menentukan tag pembuka dan penutup HTML yang berbeda, gunakan SearchParamsBuilder sebagai gantinya:

SearchParamsBuilder paramsBuilder = SearchParamsBuilder.create(searchParams);

// summary_field accepts multiple fields separated by semicolons (;)
paramsBuilder.addCustomParam("summary",
    "summary_field:name,summary_ellipsis:...,summary_snipped:1,summary_len:50," +
    "summary_element_prefix:<abc>,summary_element_postfix:</abc>");

Batasan

Indeks diperlukan untuk sorotan: Untuk menyorot kata kunci kueri dengan warna merah pada suatu bidang, buat terlebih dahulu indeks pada bidang tersebut. Tanpa indeks, sorotan mungkin tidak berfungsi.
Batas panjang ringkasan: Panjang total maksimum ringkasan adalah 10.000 byte. Kata kunci kueri yang muncul setelah batas 10.000 byte tidak disorot dengan warna merah.
Tag HTML bersifat spesifik per bidang: Atur tag HTML untuk suatu bidang sebagai bagian dari konfigurasi ringkasan untuk bidang tersebut. Anda tidak dapat mengaturnya secara terpisah.
Ringkasan multi-bidang: Jika ringkasan dikonfigurasi untuk beberapa bidang dan semua bidang tersebut berisi kata kunci kueri yang sesuai, OpenSearch menampilkan dan menyorot kata kunci tersebut dengan warna merah di seluruh bidang.
Karakter khusus difilter: Jika segmen yang disorot berisi karakter khusus, karakter tersebut difilter secara default. Untuk mempertahankan karakter khusus dalam hasil, tambahkan kvpairs=filter_punc:0 ke kueri Anda.

Peringatan

Aturan analisis yang tidak konsisten pada suatu bidang dapat menyebabkan kegagalan sorotan. Jika suatu bidang menggunakan beberapa konfigurasi analisis — misalnya, baik alat analisis bahasa Tionghoa umum maupun alat analisis karakter tunggal bahasa Tionghoa — hanya konten yang dianalisis oleh alat analisis terakhir yang diterapkan yang disorot dengan warna merah, atau konten yang tidak dimaksudkan justru disorot.

Peringatan

Jika satu klausa kueri mereferensikan dua atau lebih indeks analisis yang berbeda, konten yang sesuai mungkin tidak disorot dengan warna merah, atau konten yang salah justru disorot.

Langkah selanjutnya

Initiate search requests