OpenSearch:Ringkasan Hasil Pencarian

Dokumen sering kali panjang, sehingga tidak praktis menampilkan seluruh isinya dalam hasil pencarian. Untuk mengatasinya, Anda dapat mengonfigurasi ringkasan dan penyorotan. Sistem akan mengekstrak segmen teks yang memuat kata kunci kueri untuk membantu pengguna dengan cepat menilai relevansi suatu hasil. Pengaturan tampilan ini dapat disesuaikan di Konsol, dan setelah dikonfigurasi, secara otomatis diterapkan pada permintaan pencarian API Anda. Anda juga dapat mengganti pengaturan Konsol untuk kueri tertentu dengan menggunakan parameter summary dalam panggilan API.

Parameter

• Field: Bidang yang akan dibuat ringkasannya.

• Segment length: Panjang maksimum setiap segmen ringkasan.

• Highlight tag: Tag HTML yang digunakan untuk menyorot kata kunci.

• Segment connector: String yang digunakan untuk menghubungkan segmen-segmen ringkasan.

• Number of segments: Jumlah maksimum segmen yang dikembalikan.

Konfigurasi di Konsol

1. Di Konsol, buka Feature Extensions > Search Result Display untuk mengonfigurasi ringkasan.

2. Contoh berikut menunjukkan cara mengonfigurasi highlight tag.

Pada contoh tersebut, ringkasan dikonfigurasi untuk bidang title. Panjang segmen adalah 50, highlight tag adalah em, segment connector adalah ..., dan jumlah segmen adalah 5.

Konfigurasi API dan SDK

• API parameter: Tentukan pengaturan dengan menggunakan parameter summary.

• SDK configuration: Contoh berikut menunjukkan cara mengonfigurasi ringkasan menggunakan Java SDK:

  // Konfigurasikan ringkasan hasil pencarian. Menggunakan objek Summary merupakan cara praktis untuk menambahkan pengaturan ringkasan.
      Summary summ = new Summary("name");
      summ.setSummary_field("name");// Bidang tempat ringkasan diterapkan. Bidang ini harus berupa TEXT field dengan analyzer.
      summ.setSummary_len("50");// Panjang segmen.
      summ.setSummary_element("em"); // Highlight tag.
      summ.setSummary_ellipsis("...");// Segment connector.
      summ.setSummary_snippet("1");// Jumlah segmen.
      // Tambahkan objek Summary.

  Catatan:

• Anda tidak dapat menentukan awalan dan akhiran terpisah untuk tag sorotan dalam objek summary dari kelas SearchParams. Anda harus memberikan tag HTML lengkap. Sebagai contoh, jika Anda mengatur tag sorotan ke em, hasil yang disorot dalam tanggapan JSON untuk "Alibaba Cloud OpenSearch product document" adalah Alibaba CloudOpenSearchproduct document.

• Untuk menetapkan awalan dan akhiran kustom untuk highlight tag di SDK, gunakan objek SearchParamsBuilder.

  // Kelas utilitas untuk SearchParams yang menyediakan operasi lebih fleksibel.
        SearchParamsBuilder paramsBuilder = SearchParamsBuilder.create(searchParams);
        // Gunakan objek SearchParamsBuilder untuk menambahkan pengaturan ringkasan.
  paramsBuilder.addCustomParam("summary", "summary_field:name,summary_ellipsis:...,summary_snippet:1,summary_len:50,summary_element_prefix:<abc>,summary_element_postfix:</abc>");
       // Untuk menentukan beberapa bidang ringkasan, pisahkan dengan titik koma (;).

  Catatan penting

• Penyorotan hanya berlaku untuk kata kunci dalam kueri Anda. Bidang yang dikonfigurasi untuk penyorotan harus diindeks. Jika tidak, penyorotan mungkin tidak berfungsi sebagaimana mestinya.

• Anda harus mengonfigurasi pengaturan ringkasan dan penyorotan secara bersamaan.

• Saat Anda mengonfigurasi ringkasan untuk multiple fields, kata kunci yang sesuai akan disorot di semua bidang yang ditentukan.

• Jika kata kunci yang sesuai muncul jauh di dalam dokumen, melebihi batas 10.000 byte, kata tersebut tidak akan disorot.

• Selama proses penyorotan, tanda kurung siku literal (< dan >) dalam teks sumber akan di-escape menjadi < dan > dalam output.

• Jika Anda menerapkan analyzer berbeda pada bidang yang sama, seperti analyzer standar bahasa Tionghoa dan analyzer karakter tunggal, penyorotan mungkin salah atau tidak lengkap. Ringkasan mungkin hanya mencocokkan kata kunci berdasarkan satu analyzer atau menyorot konten yang keliru.

• Jika satu kueri menggunakan dua atau lebih Indeks dengan analyzer berbeda untuk pencarian, penyorotan mungkin gagal atau berperilaku tidak menentu.

• Secara default, karakter khusus difilter dari segmen yang disorot. Untuk menampilkan karakter-karakter tersebut, atur klausa kvpairs menjadi filter_punc:0 agar filtering ini dinonaktifkan.

Contoh ringkasan dan penyorotan

Setelah mencari kata kunci friendship, daftar hasil pencarian menampilkan segmen ringkasan untuk setiap entri, dengan kata kunci yang sesuai disorot. Setiap hasil mencakup bidang seperti title, source, author, category, status, word count, dan rating, serta tombol Start Reading. Di bagian atas halaman, Anda juga dapat memfilter hasil berdasarkan category, word count, dan status, atau mengurutkannya berdasarkan kriteria seperti update time, rating count, dan subscription count.