クエリと文書を送信
まず検索または埋め込みを使って低コストで広い候補群を取得し、その後、クエリと候補を再ランクに送ります。コーパス全体を再ランクする場合に比べ、コストと遅延を抑えられます。
結果を元の記録へ対応付けられるよう、文書には内部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を記録します。