傳送查詢與文件
先透過搜尋或嵌入向量取得成本較低的廣泛集合，再將查詢與候選項目送去重新排序。相較於重新排序整個語料庫，這可降低成本與延遲。
文件必須保留您的內部 ID，讓結果能對應回來源記錄。
重新排序請求
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
}'候選項目數
- 呼叫前將文件數量限制在合理範圍。
- top_n 應反映下一個步驟實際需要的項目數。
- 請勿將存取權不同的文件合併成一份文字。
使用分數
重新排序結果是排序訊號，不是絕對真相。請搭配存取篩選條件、時效性與業務規則使用。
記錄查詢與去識別化的候選項目 ID 供離線評估使用，不要將受限內容複製到不必要的記錄中。