Cara mengaktifkan fitur rich text di Open Search - OpenSearch

Saat Anda mengaktifkan fitur rich text, jawaban dari model bahasa besar (LLM) dapat mencakup gambar, tabel, dan blok kode yang diekstraksi dari dokumen sumber—bukan hanya teks biasa.

Cara kerja

Selama pengindeksan, pipeline RAG mengekstraksi elemen rich text (gambar, tabel, dan kode) dari setiap dokumen dan menyimpannya sebagai tag rich text bersama chunk teks terkait. Ketika kueri diajukan melalui API SearchKnowledge:

Open Search mengambil chunk yang relevan, termasuk tag rich text yang tertanam.
LLM menghasilkan jawaban menggunakan chunk yang diambil. Tag rich text dipertahankan dalam jawaban tersebut.
Bergantung pada nilai rich_text_strategy yang Anda tetapkan, Open Search akan merender tag tersebut secara inline (dalam format Markdown) atau mengembalikan konten mentahnya secara terpisah agar aplikasi Anda dapat melakukan rendering sendiri.

Aktifkan fitur rich text

Tetapkan parameter rich_text_strategy pada tab Other Parameters di halaman Q&A Test. Biarkan bidang ini kosong untuk menonaktifkan rich text.

Daftar drop-down rich_text_strategy menyediakan dua opsi: inside_response (menyematkan konten rich text secara inline dalam badan respons) dan extend_response (mengembalikan konten rich text sebagai ekstensi).

Array data dalam respons mungkin mencakup item dengan "type": "IMAGE". Ini adalah hasil gambar dari fase pengambilan (retrieval)—bukan output dari fitur rich text. Gambar yang dihasilkan oleh rich text muncul di data.answer (untuk inside_response) atau di data.rich_text_ref (untuk extend_response), dan memiliki relevansi kontekstual yang lebih baik dibandingkan gambar dari fase pengambilan.

Pilih strategi

Parameter rich_text_strategy menerima dua nilai. Pilih berdasarkan cara aplikasi Anda merender konten:

Strategi	Format respons	Pengiriman rich text	Paling cocok untuk
`inside_response`	Markdown	Inline dalam `data.answer`	Aplikasi yang secara native merender Markdown
`extend_response`	Teks biasa	Terpisah dalam `data.rich_text_ref`	Aplikasi dengan logika rendering kustom

Konfigurasikan parameter

Tambahkan rich_text_strategy ke objek options.chat dalam permintaan API SearchKnowledge Anda:

{
  "question": {
    "text": "How do I configure a sensitive data identification rule?",
    "type": "TEXT"
  },
  "options": {
    "chat": {
      "rich_text_strategy": "inside_response"
    }
  }
}

Referensi parameter API

Parameter ini termasuk dalam operasi API SearchKnowledge.

Parameter	Type	Wajib	Deskripsi
`options.chat.rich_text_strategy`	String	Tidak	Strategi pemrosesan rich text. Jika tidak ada atau kosong, rich text dinonaktifkan dan metode pemrosesan default digunakan. Nilai yang valid: `inside_response`, `extend_response`.

Uraikan respons

`inside_response`

Uraikan data.answer sebagai Markdown. Tag rich text diselesaikan secara inline—tabel muncul sebagai HTML di dalam Markdown. Abaikan bidang rich_text_ref.

`extend_response`

Uraikan data.answer sebagai teks biasa. Jawaban berisi placeholder rich text dalam format [^<id>^]. Cari setiap ID placeholder dalam array data.rich_text_ref dan ganti dengan konten yang sesuai.