AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu

$rerank 集計パイプライン ステージ

$rerank

The $rerank stage reorders input documents using Voyage AI's reranking models and returns the same documents sorted by relevance to the query. The $rerank stage can appear anywhere in an aggregation pipeline. MongoDB recommends that you use $rerank after a $vectorSearch, $search, $rankFusion, or $scoreFusion stage.

$rerankパイプラインステージの構文は 次のとおり です。

{
"$rerank": {
"query": {
"text": "<query-text>"
},
"path": "<text-field-name>",
"numDocsToRerank": <number-of-documents-to-rerank>,
"model": "<reranker-model>"
}
}

$rerankステージは、次のフィールドを持つドキュメントを取得します。

フィールド
タイプ
必要性
説明

query

オブジェクト

必須

再ランク付けに使用するクエリ。

query.
text

文字列

必須

再ランク付けに使用するクエリテキスト。例、以下のように指定できます。

  • 検索しているもの

  • ドキュメントのどのフィールドが最も関連性があるか

  • あいまいなクエリを明確にするための補完情報

path

文字列または複数の文字列の配列

必須

再ランク付けに使用するフィールドへのパス。$rerank が中間ステージである場合は、前のステージの結果からフィールドを指定します。

注: path で指定されたフィールドが存在しない場合、$rerank クエリは失敗します。欠落しているフィールドを持つドキュメントをフィルタリングで除外するには、前の $match ステージを使用します。または、$set を使用して欠落しているフィールドを "" に設定します。

numDocsToRerank

Int

必須

再ランク付けおよび結果で返されるために投票AIに送信するドキュメントの最大数。ドキュメントは、パイプラインに定義されたドキュメント順序に基づいて選択されます。

最大値は 1000 以下である必要があります。

model

オブジェクト

必須

ドキュメントの再ランク付けに使用する投票AIモデル。値は、次のモデルのいずれかになります。

  • rerank-3 - 最も精度の高い一般的なリランカー。ほとんどのアプリケーションに推奨されます。

  • rerank-3-lite - レイテンシの影響を受けやすいアプリケーション向けに最適化された、高速でコスト効果の高いリランキング。

  • rerank-2.5 - 指示に従い、多言語をサポートすることで品質に最適化された一般的なリランカー。

  • rerank-2.5-lite - 指示に従い、多言語をサポートすることで、レイテンシと品質の両方を最適化した一般的なリランカー。

  • rerank-2 - レガシー モデル。

  • rerank-2-lite - レガシー モデル。

rerank-3rerank-3-liteモデルと9.0 モデルはプレビュー機能として利用でき、 MongoDB 以降を実行中専有クラスターが必要です。詳細については、「 要件 」を参照してください。

$rerank を使用する前に、要件、制限、$rerank の動作を確認してください。

$rerankを使用するには、次の手順です。

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 つ以上の入力ドキュメントに存在しない場合、エラーが返されます。これを軽減するには、次のものを使用します。

  • $set ステージでは、不足しているフィールドを空のstringに設定します。

  • $match ステージでは、フィールドが不足しているドキュメントをフィルターします。

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.

例: パイプラインへの Rerank スコアの追加
{
"$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 という名前のフィールドを追加します。

1db.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])