$rerankThe
$rerankstage reorders input documents using Voyage AI's reranking models and returns the same documents sorted by relevance to the query. The$rerankstage can appear anywhere in an aggregation pipeline. MongoDB recommends that you use$rerankafter a$vectorSearch,$search,$rankFusion, or$scoreFusionstage.
構文
$rerankパイプラインステージの構文は 次のとおり です。
{ "$rerank": { "query": { "text": "<query-text>" }, "path": "<text-field-name>", "numDocsToRerank": <number-of-documents-to-rerank>, "model": "<reranker-model>" } }
フィールド
$rerankステージは、次のフィールドを持つドキュメントを取得します。
フィールド | タイプ | 必要性 | 説明 |
|---|---|---|---|
| オブジェクト | 必須 | 再ランク付けに使用するクエリ。 |
| 文字列 | 必須 | 再ランク付けに使用するクエリテキスト。例、以下のように指定できます。
|
| 文字列または複数の文字列の配列 | 必須 | 再ランク付けに使用するフィールドへのパス。 注: |
| Int | 必須 | 再ランク付けおよび結果で返されるために投票AIに送信するドキュメントの最大数。ドキュメントは、パイプラインに定義されたドキュメント順序に基づいて選択されます。 最大値は |
| オブジェクト | 必須 | ドキュメントの再ランク付けに使用する投票AIモデル。値は、次のモデルのいずれかになります。
|
Considerations
$rerank を使用する前に、要件、制限、$rerank の動作を確認してください。
要件
$rerankを使用するには、次の手順です。
クラスターでMongoDB 9.0 以降を実行中いることを確認します。
Project Settingsを使用してネイティブ再ランク付けを有効にします。詳しくは、ネイティブ再ランク付けを有効または無効にする を参照してください。
rerank-3 モデルと rerank-3-lite モデルには次の追加要件があります。
M10クラスターは、 MongoDB 以降を実行中専有クラスター(9.0 以上)である必要があります。
これらのモデルのサポート ステータスについては、「 現在のモデル ステータス 」を参照してください。
制限
$rerank ステージは使用できません。
自己管理型または Atlas Local 配置の場合。
$rankFusionまたは$scoreFusion入力パイプラインの場合。View 上に MongoDB Search または MongoDB Vector Search インデックスがある場合は、View の代わりにソース コレクションで
.aggregate()を実行してインデックスをクエリします。
rerank-3 モデルと rerank-3-lite モデルには、次の追加の制限があります。
MongoDB 9.0 以降を実行中専用クラスター(
M10以上)でのみ使用できます。無料クラスター(
M0)または Flex クラスターではまだ使用できません。
動作
$rerank はパイプラインのどこにでも表示できます。ただし、 MongoDB、関連するドキュメントがすでにソートされている順序で返される、$search や $vectorSearch などのステージの後に $rerank を使用することを推奨しています。
$rerank は再ランク付けされ、 ステージに渡される最初の numDocsToRerank ドキュメントを返します。$rerank が最初のステージであるか、その前のステージで明確にソートされた結果が返されない場合、$rerank に使用されるドキュメントはクエリ間で変更される可能性があります。
$rerank path で指定されたフィールドのいずれかが 1 つ以上の入力ドキュメントに存在しない場合、エラーが返されます。これを軽減するには、次のものを使用します。
クエリ
query.textフィールドは、リランカーモデルが各ドキュメントをスコア付けする方法を決定します。指定された投票リランカー モデルは、指定された path のクエリテキストと各ドキュメントの内容との間の関連性スコアを計算します。ほとんどのユースケースでは、$rerank.query.text を、前の $search または $vectorSearch ステージのクエリと同じか類似したテキストに設定します。
スコアリング
Use the score variable with the $meta expression to retrieve the score of each document in the results of the $rerank stage.
{ "$addFields": { "rerankScore": { "$meta": "score" } } }
$rerank ステージでは、$meta: "score" の値が新しいスコアに置き換えられます。$rankFusion のように先行するステージの値を保持するには、$rerank ステージの前の名前付きフィールドにスコアをプロジェクトします。
{ "$addFields": { "originalRankFusionScore": { "$meta": "score" } } }, { "$rerank": { ... } }, { "$addFields": { "rerankScore": { "$meta": "score" } } }
パフォーマンスと精度
The $rerank stage can be computationally expensive, depending on the size of the input such as the fields to rerank over, the number of documents to rerank, and the query text. $rerank processes queries and documents jointly at query time. Therefore, $rerank might be slower than relevancy search powered by an index, such as the indexes for $search or $vectorSearch. To balance accuracy and performance, configure numDocsToRerank and path to limit the input size. $rerank does not run Voyage AI reranking models on your Atlas cluster resources.
$rerank RAG やエージェント AI アプリケーションなど、超低レイテンシが優先されるよりも取得品質が優先されるワークロードに最適です。超低レイテンシが必要なワークロードの場合、MongoDB は $search や $vectorSearch のようなインデックスを利用した検索ステージの使用をお勧めします。
例
次の例は、$rerank ステージを使用して、Vyage AIリランクモデルに基づいて sample_mflix.embedded_moviesコレクション内のドキュメントを順序付けする方法を示しています。クエリは、$match ステージの後に $rerank を使用して、rerank-2.5 リランク モデルを使用してドキュメントを並べ替えます。次の集計パイプラインでは、 は次のようになります。
$matchステージでは、ドキュメントをフィルタリングして、plotフィールドが string 型のドキュメントのみを含めます。$sortステージでは、ドキュメントをreleasedフィールドの降順でソートし、確実な順序付けを確保します。$rerankステージでは、rerank-2.5リランク モデルを使用して、クエリに一致するようにドキュメントが並べ替えられます。$addFieldsステージはドキュメントにrerankScoreという名前のフィールドを追加します。
1 db.embedded_movies.aggregate([ 2 { 3 "$match": { 4 "plot": { "$exists": true, "$type": "string" } 5 } 6 }, 7 { 8 "$sort": { "released": -1 } 9 }, 10 { 11 "$rerank": { 12 "model": "rerank-2.5", 13 "query": { 14 "text": "a group of heroes band together to stop a powerful enemy and save the world" 15 }, 16 "numDocsToRerank": 100, 17 "path": ["title", "plot"] 18 } 19 }, 20 { 21 "$addFields": { 22 "rerankScore": { "$meta": "score" } 23 } 24 }, 25 { "$limit": 10 }, 26 { 27 "$project": { 28 "_id": 0, 29 "title": 1, 30 "plot": 1, 31 "rerankScore": 1 32 } 33 } 34 ])