Hasil pencarian
Aktifkan kutipan alami untuk aplikasi RAG dengan menyediakan hasil pencarian dengan atribusi sumber
Blok konten hasil pencarian saat ini dalam versi beta. Gunakan header beta search-results-2025-06-09
beta header untuk mengaktifkan fitur ini.
Blok konten hasil pencarian memungkinkan kutipan alami dengan atribusi sumber yang tepat, membawa kutipan berkualitas pencarian web ke aplikasi kustom Anda. Fitur ini sangat powerful untuk aplikasi RAG (Retrieval-Augmented Generation) di mana Anda memerlukan Claude untuk mengutip sumber secara akurat.
Manfaat utama
- Kutipan alami - Mencapai kualitas kutipan yang sama dengan pencarian web untuk konten apa pun
- Integrasi fleksibel - Gunakan dalam pengembalian tool untuk RAG dinamis atau sebagai konten tingkat atas untuk data yang sudah diambil sebelumnya
- Atribusi sumber yang tepat - Setiap hasil mencakup informasi sumber dan judul untuk atribusi yang jelas
- Tidak perlu solusi alternatif dokumen - Menghilangkan kebutuhan untuk solusi alternatif berbasis dokumen
- Format kutipan yang konsisten - Sesuai dengan kualitas dan format kutipan dari fungsionalitas pencarian web Claude
Cara kerjanya
Hasil pencarian dapat disediakan dalam dua cara:
- Dari panggilan tool - Tool kustom Anda mengembalikan hasil pencarian, memungkinkan aplikasi RAG dinamis
- Sebagai konten tingkat atas - Anda menyediakan hasil pencarian langsung dalam pesan pengguna untuk konten yang sudah diambil sebelumnya atau di-cache
Dalam kedua kasus, Claude dapat secara otomatis mengutip informasi dari hasil pencarian dengan atribusi sumber yang tepat.
Skema hasil pencarian
Hasil pencarian menggunakan struktur berikut:
Field wajib
Field | Type | Deskripsi |
---|---|---|
type | string | Harus "search_result" |
source | string | URL sumber atau identifier untuk konten |
title | string | Judul deskriptif untuk hasil pencarian |
content | array | Array blok teks yang berisi konten aktual |
Field opsional
Field | Type | Deskripsi |
---|---|---|
citations | object | Konfigurasi kutipan dengan field boolean enabled |
cache_control | object | Pengaturan kontrol cache (misalnya, {"type": "ephemeral"} ) |
Setiap item dalam array content
harus berupa blok teks dengan:
type
: Harus"text"
text
: Konten teks aktual (string tidak kosong)
Metode 1: Hasil pencarian dari panggilan tool
Kasus penggunaan paling powerful adalah mengembalikan hasil pencarian dari tool kustom Anda. Ini memungkinkan aplikasi RAG dinamis di mana tool mengambil dan mengembalikan konten relevan dengan kutipan otomatis.
Contoh: Tool basis pengetahuan
Metode 2: Hasil pencarian sebagai konten tingkat atas
Anda juga dapat menyediakan hasil pencarian langsung dalam pesan pengguna. Ini berguna untuk:
- Konten yang sudah diambil sebelumnya dari infrastruktur pencarian Anda
- Hasil pencarian yang di-cache dari query sebelumnya
- Konten dari layanan pencarian eksternal
- Testing dan development
Contoh: Hasil pencarian langsung
Respons Claude dengan kutipan
Terlepas dari bagaimana hasil pencarian disediakan, Claude secara otomatis menyertakan kutipan ketika menggunakan informasi dari mereka:
Field kutipan
Setiap kutipan mencakup:
Field | Type | Deskripsi |
---|---|---|
type | string | Selalu "search_result_location" untuk kutipan hasil pencarian |
source | string | Sumber dari hasil pencarian asli |
title | string atau null | Judul dari hasil pencarian asli |
cited_text | string | Teks persis yang dikutip |
search_result_index | integer | Indeks hasil pencarian (berbasis 0) |
start_block_index | integer | Posisi awal dalam array konten |
end_block_index | integer | Posisi akhir dalam array konten |
Catatan: search_result_index
merujuk pada indeks blok konten hasil pencarian (berbasis 0), terlepas dari bagaimana hasil pencarian disediakan (panggilan tool atau konten tingkat atas).
Beberapa blok konten
Hasil pencarian dapat berisi beberapa blok teks dalam array content
:
Claude dapat mengutip blok spesifik menggunakan field start_block_index
dan end_block_index
.
Penggunaan lanjutan
Menggabungkan kedua metode
Anda dapat menggunakan hasil pencarian berbasis tool dan tingkat atas dalam percakapan yang sama:
Menggabungkan dengan jenis konten lain
Kedua metode mendukung pencampuran hasil pencarian dengan konten lain:
Kontrol cache
Tambahkan kontrol cache untuk performa yang lebih baik:
Kontrol kutipan
Secara default, kutipan dinonaktifkan untuk hasil pencarian. Anda dapat mengaktifkan kutipan dengan secara eksplisit mengatur konfigurasi citations
:
Ketika citations.enabled
diatur ke true
, Claude akan menyertakan referensi kutipan ketika menggunakan informasi dari hasil pencarian. Ini memungkinkan:
- Kutipan alami untuk aplikasi RAG kustom Anda
- Atribusi sumber ketika berinteraksi dengan basis pengetahuan proprietary
- Kutipan berkualitas pencarian web untuk tool kustom apa pun yang mengembalikan hasil pencarian
Jika field citations
dihilangkan, kutipan dinonaktifkan secara default.
Kutipan bersifat semua-atau-tidak-sama-sekali: baik semua hasil pencarian dalam permintaan harus memiliki kutipan yang diaktifkan, atau semua harus dinonaktifkan. Mencampur hasil pencarian dengan pengaturan kutipan yang berbeda akan menghasilkan error. Jika Anda perlu menonaktifkan kutipan untuk beberapa sumber, Anda harus menonaktifkannya untuk semua hasil pencarian dalam permintaan tersebut.
Praktik terbaik
Untuk pencarian berbasis tool (Metode 1)
- Konten dinamis: Gunakan untuk pencarian real-time dan aplikasi RAG dinamis
- Penanganan error: Kembalikan pesan yang sesuai ketika pencarian gagal
- Batas hasil: Kembalikan hanya hasil yang paling relevan untuk menghindari overflow konteks
Untuk pencarian tingkat atas (Metode 2)
- Konten yang sudah diambil sebelumnya: Gunakan ketika Anda sudah memiliki hasil pencarian
- Pemrosesan batch: Ideal untuk memproses beberapa hasil pencarian sekaligus
- Testing: Bagus untuk menguji perilaku kutipan dengan konten yang diketahui
Praktik terbaik umum
-
Struktur hasil secara efektif
- Gunakan URL sumber yang jelas dan permanen
- Berikan judul yang deskriptif
- Pecah konten panjang menjadi blok teks yang logis
-
Pertahankan konsistensi
- Gunakan format sumber yang konsisten di seluruh aplikasi Anda
- Pastikan judul secara akurat mencerminkan konten
- Jaga format tetap konsisten
-
Tangani error dengan baik
Keterbatasan
- Blok konten hasil pencarian hanya tersedia dengan header beta
- Hanya konten teks yang didukung dalam hasil pencarian (tidak ada gambar atau media lain)
- Array
content
harus berisi setidaknya satu blok teks