All Products
Search

This Product

    OpenSearch:Ringkasan hasil pencarian

    Document Center

    OpenSearch:Ringkasan hasil pencarian

    Last Updated:Jun 21, 2026

    Dokumen sering kali panjang sehingga tidak dapat ditampilkan secara lengkap dalam hasil pencarian. Untuk mengatasinya, Anda dapat mengonfigurasi ringkasan hasil pencarian dan penyorotan (highlighting). Sistem akan mengekstraksi segmen yang berisi kata kunci kueri untuk membantu pengguna dengan cepat menilai relevansi suatu hasil. Tampilan hasil pencarian dapat disesuaikan melalui Konsol. Setelah dikonfigurasi di Konsol, pengaturan ini diterapkan secara otomatis pada kueri API tanpa perlu ditentukan ulang dalam setiap permintaan. Namun, Anda tetap dapat mengganti pengaturan tersebut untuk kueri tertentu dengan menggunakan parameter summary dalam permintaan API. Untuk informasi selengkapnya, lihat Initiate search requests.

    Parameter

    • Field: Bidang yang akan dibuat ringkasan hasil pencariannya.

    • Segment length: Panjang maksimum seluruh ringkasan hasil pencarian.

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

    • Segment connector: Karakter atau string yang digunakan untuk menggabungkan segmen.

    • Number of segments: Jumlah segmen yang ditampilkan dalam panjang ringkasan yang ditentukan.

    Konfigurasi di Konsol

    1. Di Konsol, buka OpenSearch High-performance Search Edition > Feature Extensions > Search Result Display, lalu konfigurasikan pengaturan di bagian Search Result Summary.

    2. Contoh berikut menunjukkan konfigurasi untuk penyorotan dengan tag sorot yang diatur ke em.

    Di bagian Search Result Summary Konsol, panjang segmen untuk bidang title diatur ke 50, tag sorot ke em, penghubung segmen ke ..., dan jumlah segmen ke 5.

    Konfigurasi API dan SDK

    • API: Tentukan parameter summary dalam permintaan Anda. Untuk informasi selengkapnya, lihat Initiate search requests.

    • SDK: Contoh berikut menunjukkan cara mengonfigurasi ringkasan hasil pencarian menggunakan Java SDK:

      // Konfigurasikan ringkasan hasil pencarian. Objek SearchParams menyediakan cara simple untuk melakukan ini.
    Summary summ = new Summary("name");
    summ.setSummary_field("name");// Bidang tempat ringkasan diterapkan. Bidang ini harus merupakan bidang teks yang dapat dianalisis.
    summ.setSummary_len("50");// Panjang segmen.
    summ.setSummary_element("em"); // Tag sorot.
    summ.setSummary_ellipsis("...");// Penghubung segmen.
    summ.setSummary_snippet("1");// Jumlah segmen.

      Catatan:

    • Saat menggunakan objek summary dari kelas SearchParams, Anda tidak dapat menentukan awalan atau akhiran kustom untuk tag sorot. Anda harus menggunakan nama tag HTML lengkap. Secara default, awalan dan akhiran adalah < dan >. Sebagai contoh, jika tag sorot diatur ke em, hasil JSON yang dikembalikan diformat sebagai Alibaba CloudOpenSearchproduct document.

    • Untuk mengatur awalan dan akhiran kustom untuk tag sorot di SDK, gunakan objek searchParamsBuilder.

      // Kelas utilitas untuk SearchParams yang menyederhanakan operasi.
      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>");
     // Untuk menentukan beberapa nilai summary_field, pisahkan dengan titik koma (;).

      Catatan penggunaan

    • Penyorotan hanya berlaku untuk kata kunci dalam kueri Anda. Bidang yang akan disorot harus telah diindeks; jika tidak, penyorotan mungkin tidak berfungsi dengan benar.

    • Anda tidak dapat mengonfigurasi ringkasan dan penyorotan secara terpisah.

    • Jika Anda mengonfigurasi ringkasan untuk beberapa bidang, kata kunci kueri yang cocok akan disorot di semua bidang yang ditentukan.

    • Jika kata kunci yang cocok muncul jauh di dalam konten—melebihi batas 10.000 byte—kata tersebut tidak akan disorot.

    • Jika Anda membuat jenis alat analisis yang berbeda untuk bidang yang sama, seperti alat analisis bahasa Tionghoa standar dan alat analisis karakter tunggal, penyorotan mungkin tidak berfungsi dengan benar. Misalnya, konten mungkin hanya disorot berdasarkan satu alat analisis, atau bagian yang salah mungkin disorot.

    • Penyorotan mungkin tidak berfungsi dengan benar jika kueri menggunakan beberapa alat analisis.

    • Secara default, karakter khusus dalam segmen yang disorot difilter dari dokumen yang dikembalikan. Untuk menampilkan karakter tersebut, tambahkan klausa kustom kvpairs=filter_punc:0 ke kueri Anda agar penyaringan ini dinonaktifkan.