重要
ネイティブ再ランキングはプレビュー機能として利用できます。機能および関連するドキュメントは、プレビュー期間中に随時変更される可能性があります。したがって、本機能を製品環境で使用することはお勧めしません。現在のところ、この機能からのカスタマーデータはモデルのトレーニングには使用していません。詳細については、「プレビュー機能」を参照してください。
$rerank$rerankステージは、Voyage AI の再ランクモデルを使用して入力ドキュメントの順序を変更し、クエリに対する関連性に基づいてソートされた同じドキュメントを返します。$rerankステージは、集計パイプライン内のどこにでも表示できます。MongoDB は、$vectorSearch、$search、$rankFusion、または$scoreFusionステージの後に$rerankを使用することをお勧めします。
構文
$rerankパイプラインステージの構文は 次のとおり です。
{ "$rerank": { "query": { "text": "<query-text>" }, "path": "<text-field-name>", "numDocsToRerank": <number-of-documents-to-rerank>, "model": "<reranker-model>" } }
フィールド
$rerankステージは、次のフィールドを持つドキュメントを取得します。
フィールド | タイプ | 必要性 | 説明 |
|---|---|---|---|
| オブジェクト | 必須 | 再ランク付けに使用するクエリ。 |
| 文字列 | 必須 | 再ランク付けに使用するクエリテキスト。例、以下のように指定できます。
|
| 文字列または複数の文字列の配列 | 必須 | |
| Int | 必須 | 再ランク付けおよび結果で返されるために投票AIに送信するドキュメントの最大数。ドキュメントは、パイプラインに定義されたドキュメント順序に基づいて選択されます。 最大値は |
| オブジェクト | 必須 | ドキュメントを再ランクするために使用する Voyage AI モデル。値は次のいずれかのモデルになります。
|
Considerations
$rerank を使用する前に、要件、制限、$rerank の動作を確認してください。
要件
$rerankを使用するには、次の手順です。
Atlas UI Cluster Builder ページで Latest version with auto-upgrades を選択して、クラスターが MongoDB 8.3 以降で実行されていることを確認します。
Project Settingsを使用してネイティブ再ランク付けを有効にします。詳しくは、ネイティブ再ランク付けを有効または無効にする を参照してください。
制限
$rerank ステージは使用できません。
自己管理型または Atlas Local 配置の場合。
$rankFusionまたは$scoreFusion入力パイプライン用。ビューに対するクエリの場合。
View 上に MongoDB Search または MongoDB Vector Search インデックスがある場合は、View の代わりにソース コレクションで
.aggregate()を実行してインデックスをクエリします。
動作
$rerank はパイプラインのどこにでも表示されます。ただし、MongoDBでは、既にソートされた順序で関連するドキュメントを返す$searchや$vectorSearchのようなステージの後に$rerankを使用することをお勧めします。
$rerank は再ランク付けされ、 ステージに渡される最初の numDocsToRerank ドキュメントを返します。$rerank が最初のステージであるか、その前のステージで明確にソートされた結果が返されない場合、$rerank に使用されるドキュメントはクエリ間で変更される可能性があります。
$rerank path で指定されたフィールドのいずれかが 1 つ以上の入力ドキュメントに存在しない場合、エラーが返されます。これを軽減するには、次のものを使用します。
クエリ
query.textフィールドは、リランカー モデルが各ドキュメントのスコアを計算する方法を決定します。指定されたVoyage リランカー モデルは、指定されたpathでクエリ テキストと各ドキュメントのコンテンツの間の関連度スコアを計算します。ほとんどのユースケースでは、$rerank.query.textを前の$searchまたは$vectorSearchステージのクエリと同じまたは類似したテキストに設定します。
スコアリング
score 変数と $meta 式を組み合わせて、$rerank ステージの結果内の各ドキュメントのスコアを取得します。
{ "$addFields": { "rerankScore": { "$meta": "score" } } }
$rerank ステージでは、$meta: "score" の値が新しいスコアに置き換えられます。$rankFusion のように先行するステージの値を保持するには、$rerank ステージの前の名前付きフィールドにスコアをプロジェクトします。
{ "$addFields": { "originalRankFusionScore": { "$meta": "score" } } }, { "$rerank": { ... } }, { "$addFields": { "rerankScore": { "$meta": "score" } } }
パフォーマンスと精度
$rerank ステージは、再ランクするフィールド、再ランクするドキュメントの数、クエリ テキストなどの入力のサイズに応じて、計算コストが高くなる可能性があります。$rerank は、クエリ時にクエリとドキュメントを合わせて処理します。したがって、$rerank は、$search や $vectorSearch のインデックスなど、インデックスによる関連性検索よりも低速になる可能性があります。正確性とパフォーマンスのバランスを取るには、numDocsToRerank と path を構成して入力サイズを制限します。$rerank は、Atlas クラスター リソース上で Voyage AI 再ランクモデルを実行しません。
$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 ])
[ { plot: 'No treason, no surrender.', title: 'Ti mene nosis', rerankScore: 0.5986876487731934 }, { plot: 'The life of the greatest karate master of a generation.', title: 'The Real Miyagi', rerankScore: 0.5986876487731934 }, { plot: 'A shy genius is employed by his former university to design robot software.', title: 'Eva', rerankScore: 0.5986876487731934 }, { plot: 'The owners of a failing security company start robbing houses to boost business.', title: 'Armed Response', rerankScore: 0.5986876487731934 }, { plot: 'A live telecast of the beloved J. M. Barrie story.', title: 'Peter Pan Live!', rerankScore: 0.5986876487731934 }, { plot: "A French police magistrate spends years trying to take down one of the country's most powerful drug rings.", title: 'The Connection', rerankScore: 0.5986876487731934 }, { plot: 'A documentary that follows undercover activists trying to stave off a man-made mass extinction.', title: 'Racing Extinction', rerankScore: 0.5986876487731934 }, { plot: 'An ex-hitman comes out of retirement to track down the gangsters that took everything from him.', title: 'John Wick', rerankScore: 0.5986876487731934 }, { plot: 'A former hit-man for a drug cartel becomes a vigilante to pay for his sins and find redemption.', title: 'Redeemer', rerankScore: 0.5986876487731934 }, { plot: 'Charles Ingvar Jènsson gathers three criminals to take vengeance upon the people who killed his uncle.', title: 'The Master Plan', rerankScore: 0.5986876487731934 } ]