Kirim kueri dan dokumen
Pertama, dapatkan kumpulan kandidat yang luas dengan biaya rendah melalui pencarian atau embedding, lalu kirim kueri dan kandidat untuk diperingkat ulang. Cara ini mengurangi biaya dan latensi dibandingkan memeringkat ulang seluruh korpus.
Dokumen harus mempertahankan ID internal Anda agar hasil dapat dipetakan kembali ke catatan sumber.
Permintaan pemeringkatan ulang
bash
curl --request POST https://cicora.ai/api/v1/rerank \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "cohere/rerank-v3.5",
"query": "How do I change a subscription?",
"documents": ["Billing changes are in Settings.", "Images can be generated from a prompt."],
"top_n": 1
}'Ukuran kandidat
- Batasi dokumen ke jumlah yang wajar sebelum pemanggilan.
- top_n sebaiknya mencerminkan jumlah item yang benar-benar diperlukan pada langkah berikutnya.
- Jangan gabungkan dokumen dengan hak akses berbeda menjadi satu teks.
Gunakan skor
Hasil pemeringkatan ulang adalah sinyal urutan, bukan kebenaran mutlak. Gabungkan dengan filter akses, kebaruan, dan aturan bisnis.
Catat kueri dan ID kandidat yang telah dihilangkan identitasnya untuk evaluasi luring tanpa menyalin konten dengan akses terbatas ke log yang tidak diperlukan.