OpenSearch：Ringkasan Hasil Pencarian

Dalam banyak kasus, dokumen berukuran besar. Saat mencari dokumen, seluruh isi mungkin tidak ditampilkan. Untuk membantu pengguna memahami isi utama dokumen dan menentukan relevansinya, OpenSearch menyediakan fitur ringkasan hasil pencarian. Fitur ini memungkinkan Anda menentukan konten yang akan ditampilkan dan disorot dalam hasil pencarian. Sistem menampilkan segmen konten yang mengandung istilah kueri di hasil pencarian. Anda dapat mengonfigurasi efek tampilan hasil pencarian di konsol OpenSearch. Setelah konfigurasi selesai, sistem secara otomatis mengambil parameter yang telah diatur saat Anda memanggil operasi API, sehingga Anda tidak perlu lagi memasukkan parameter ringkasan secara manual. Namun, Anda juga dapat mengonfigurasi parameter ringkasan langsung dalam operasi API untuk menyesuaikan hasil pencarian. Untuk informasi lebih lanjut, lihat Memulai permintaan pencarian.

• Bidang: Bidang yang ingin Anda konfigurasikan untuk ringkasan.

• Panjang Segmen: Panjang maksimum sebuah segmen.

• Tag HTML untuk Sorotan: Tag HTML yang digunakan untuk menyorot istilah kueri dengan warna merah.

• Penghubung Segmen: Penghubung yang digunakan untuk menggabungkan segmen-segmen.

• Jumlah Segmen: Jumlah segmen yang diperlukan dalam ringkasan hasil pencarian dengan panjang tertentu.

1. Masuk ke konsol OpenSearch. Di panel navigasi sebelah kiri, pilih Ekstensi Fitur > Tampilan Hasil Pencarian. Di halaman Tampilan Hasil Pencarian, konfigurasikan ringkasan hasil pencarian.

2. Gambar berikut menunjukkan tag HTML yang dikonfigurasikan untuk sebuah bidang. Tag HTML untuk Sorotan diatur menjadi em untuk bidang judul.

• Parameter API: Anda dapat mengonfigurasi parameter API dengan menentukan parameter ringkasan.

• SDK: Contoh kode berikut menunjukkan cara mengonfigurasi tag HTML dengan memanggil SDK untuk Java.

  // Konfigurasikan ringkasan hasil pencarian. Objek SearchParams digunakan untuk menambahkan ringkasan hasil pencarian.
      Summary summ = new Summary("name");
      summ.setSummary_field("name");// Tentukan bidang-bidang yang ingin Anda konfigurasikan ringkasannya. Anda harus menentukan bidang bertipe TEXT yang dapat dianalisis. 
      summ.setSummary_len("50");// Tentukan panjang segmen.
      summ.setSummary_element("em"); // Tentukan nama tag HTML yang digunakan untuk menyorot kueri pencarian dengan warna merah.
      summ.setSummary_ellipsis("...");// Tentukan penghubung yang digunakan untuk menggabungkan segmen.
      summ.setSummary_snippet("1");// Tentukan jumlah segmen.
      // Tambahkan parameter ringkasan.

  Catatan:

• Parameter ringkasan dalam objek SearchParams dari SDK tidak dapat digunakan untuk mengonfigurasi awalan dan akhiran tag HTML yang digunakan untuk menyorot istilah kueri dengan warna merah. Anda harus menentukan tag HTML lengkap yang terdiri dari awalan dan akhiran. Secara default, awalan dan akhiran adalah <>. Sebagai contoh, atur tag HTML menjadi em untuk sebuah bidang. Hasil kueri untuk bidang tersebut dikembalikan dalam format JSON dengan konten sorotan berwarna merah: Alibaba Cloud<em>OpenSearch</em>dokumen produk.

• Untuk mengonfigurasi awalan dan akhiran tag HTML menggunakan SDK, gunakan objek SearchParamsBuilder.

  // Buat objek SearchParamsBuilder. Sebagai kelas utilitas dari SearchParams, objek SearchParamsBuilder memungkinkan Anda mengonfigurasi parameter terkait kueri dengan mudah.
        SearchParamsBuilder paramsBuilder = SearchParamsBuilder.create(searchParams);
        // Gunakan objek SearchParamsBuilder untuk menambahkan ringkasan hasil pencarian.
  paramsBuilder.addCustomParam("summary", "summary_field:name,summary_ellipsis:...,summary_snipped:1,summary_len:50,summary_element_prefix:<abc>,summary_element_postfix:</abc>");
       // Pisahkan beberapa nilai parameter summary_field dengan titik koma (;).

  Catatan Penggunaan

• Hanya istilah kueri yang dapat disorot dengan warna merah. Anda harus membuat indeks untuk bidang yang digunakan untuk menyorot istilah kueri dengan warna merah. Jika tidak, kesalahan mungkin terjadi.

• Anda harus menentukan tag HTML untuk sebuah bidang saat mengonfigurasi ringkasan hasil pencarian untuk bidang tersebut.

• Jika Anda mengonfigurasi ringkasan hasil pencarian untuk beberapa bidang dan nilai-nilai bidang tersebut mengandung istilah kueri yang ditentukan dalam indeks, istilah kueri dalam bidang tersebut akan ditampilkan dan disorot dengan warna merah di hasil pencarian.

• Jika istilah kueri yang cocok muncul kemudian dalam dokumen dan panjang konten sebelum istilah kueri telah melebihi batas maksimum 10.000 byte, istilah kueri tersebut tidak akan disorot dengan warna merah.

• Saat menentukan tag HTML yang digunakan untuk menyorot istilah kueri dengan warna merah, tanda kurung pembuka (<) diubah menjadi &lt; dan tanda kurung penutup (>) diubah menjadi &gt;.

• Jika aturan analisis yang berbeda dikonfigurasikan untuk sebuah bidang dalam aplikasi, konten bidang tersebut mungkin tidak disorot dengan benar dengan warna merah di hasil pencarian. Sebagai contoh, jika Anda mengonfigurasikan baik analis umum untuk bahasa Cina maupun analis karakter tunggal untuk bahasa Cina untuk sebuah bidang, hanya konten yang dianalisis berdasarkan analis karakter tunggal untuk bahasa Cina yang disorot dalam hasil pencarian atau konten yang tidak diinginkan disorot dengan warna merah di hasil pencarian.

• Dalam kueri pencarian yang sama, jika dua atau lebih indeks analisis yang berbeda dikonfigurasikan, konten yang ditentukan mungkin tidak disorot dengan warna merah atau konten yang tidak diinginkan disorot dengan warna merah.

• Jika segmen yang akan disorot dengan warna merah mengandung karakter khusus, karakter khusus tersebut difilter di hasil pencarian. Jika Anda ingin karakter khusus tersebut ditampilkan di hasil pencarian, Anda dapat menentukan kvpairs=filter_punc:0 untuk melewati penyaringan.