VoyageAI by MongoDB: rerank-3
Voyage rerank-3 は、クエリと文書の関連性を採点する、品質重視の Rerank 3 版です。取得したテキスト候補を並べ替え、自然言語の関連性指示に対応し、長文、コード、ナレッジベース検索のために 32,000 トークンの組を処理します。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
Voyage rerank-3 は、取得した根拠の品質を高めるために設計されたテキストリランカーです。クエリと候補文書の一覧を渡すと、各組を一緒に調べ、関連性の順に候補を返します。まず埋め込み検索やキーワード検索で大きな資料群を扱いやすい候補一覧に絞り、その一覧に rerank-3 がより詳しい関連性評価を適用します。出力は、アプリケーションが表示したり、別の回答生成段階へ渡したりする、採点済みの検索根拠です。
品質重視の Rerank 3 開発元は、rerank-3 を精度重視版、rerank-3-lite を遅延に敏感な検索向けの版と位置付けています。第 3 世代は基盤と学習データの混合を更新し、対応する 2.5 世代の前モデルに比べて、特に長文とソースコードの検索を改善しています。開発元は、技術文書、コード、多言語資料、その他の文書分野で評価しています。その結果は検索用途を裏付けるものです。自分の資料群で重要な質問と候補文書を使って、版を選んでください。
十分な文脈を持つ長い文書 長い候補には、冒頭の段落よりはるか後ろに有用な文脈がある場合があります。モデルが実際の質問と内容の関係を評価できるよう、まとまりのある節や文書を、タイトルと関連する周辺資料とともに渡してください。製品の方針を検索する場合は、対象文章の周囲にある見出しと例外を残します。同じ出典から複数の節を取得した場合は、文書と節の識別子を保持し、アプリケーションが選ばれた根拠の出所を示せるようにしてください。
コンテキストウィンドウは、クエリと各候補が共有します。開発元の現在のガイドは、各組を 32,000 トークン、そのうちクエリを最大 8,000 トークンとしています。したがって、3,000 トークンのクエリでは、各文書に残るのは最大 29,000 トークンです。特に長い前置きや繰り返しの定型文が容量を消費する場合は、重要な内容が収まるよう入力を用意してください。文書化された切り詰めオプションはデフォルトで有効で、長すぎるクエリや文書のテキストを採点前に短縮する場合があります。文章の位置が重要なら、何が残るかを確認します。
コードと技術情報の検索 コーディング支援の検索段階では、候補に関数実装、API 文書、技術的な説明をテキストとして含められます。似た候補を区別するために必要なシンボル、シグネチャ、文脈を含めてください。「末尾の区切り文字を維持しながらパスを正規化する関数を見つけてください」といったクエリは、照合する具体的な挙動を示します。関連する言語、プラットフォーム、バージョンの制約も添えます。順位付けの後、コンテキストに使う前に、選ばれたコードと依存関係を調べてください。関連性スコアは、実装がすべての要件を満たす証明ではありません。
指示で関連性を定める モデルは、Rerank 2.5 で導入された指示追従型の再順位付け能力を維持しています。利用者の意図を明確にする必要がある場合は、クエリの前後に簡潔な指示を添えてください。調査文書の検索では、タイトル、特定の手法、応用分野のいずれを重視するかを説明します。社内カタログでは、依頼がインストール、トラブルシューティング、互換性のいずれに関するものかを指定してください。指示を質問に合わせます。主な依頼と食い違う追加の希望は、ランキングが最適化しようとする対象を変える場合があります。
候補文書と予算を用意する 入力は、テキスト文字列の一覧です。原文書から使えるテキストを抽出し、意味のある節の境界を保ち、一覧とともに順序付きの記録対応を保持してください。開発元は、1 回のリクエストに最大 1,000 文書を認めています。また、入力全体の上限を 600,000 トークンとし、クエリのトークン数に文書数を掛け、すべての文書のトークン数の合計を加えます。これは組ごとのコンテキスト上限とは異なります。クエリの重複テキストを減らすと、組の容量とリクエスト全体の予算の両方を保てます。
語数や文字数がトークン数であると仮定せず、該当モデルでトークンを数えてください。大きな候補では、まとまりのある文章を選ぶか、有用な見出しで資料を分割し、親出典の情報を残します。再順位付けは、最初の検索が有望な候補をすでに見つけている場合に最も役立ちます。一覧に入らなかった出典を順位付けすることはできません。
順位付きの結果と後続での利用 結果には、元の入力文書を指す関連性スコアとインデックスが含まれ、関連性の高い順に並びます。top_k オプションは返す順位付き結果数を制限し、指定しなければすべての入力候補を返します。開発元の REST インターフェースでは、文書テキストも含められます。元の各インデックスから、タイトル、出典識別子、アプリケーションに必要なメタデータを取得し、選んだ項目を表示するか、関連テキストを回答の根拠用コンテキストにまとめてください。
上位結果を質問と照合し、出典の識別情報を見える形に保ちます。相対的な順位が高くても、文書の事実の正確さは検証されません。また、質の低い候補しかない一覧でも、先頭の項目は存在します。関連性による選択と、選んだ根拠で利用者に答えるのに十分かという判断を分けてください。
版の移行 開発元は、rerank-3 を、API の意味が同じで、対応する前モデルの分布にスコアを校正した、rerank-2.5 のそのまま置き換え可能な後継と説明しています。この互換性により、既存の検索段階と記録対応を維持できます。移行に頼る前に、現在の資料群で意味のある結果順序とスコア閾値を比較してください。rerank-3 と rerank-3-lite は別の選択肢として保ちます。上限と指示追従が共通でも、品質と遅延の優先度まで同じになるわけではありません。
Ailoot Ultra · 再ランキング POST /v1/rerank voyageai/rerank-3
voyageai/rerank-3はじめに
Voyage rerank-3 は、クエリと文書の関連性を採点する、品質重視の Rerank 3 版です。取得したテキスト候補を並べ替え、自然言語の関連性指示に対応し、長文、コード、ナレッジベース検索のために 32,000 トークンの組を処理します。
- 対応する入力
- テキスト
- 結果
- 順位付きの結果
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · 再ランキング POST /v1/rerank
- 入力の種類
text- 出力の種類
rerank- 出力形式
- json
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドdocuments | 種類array | 要件必須 | 値と制限 | デフォルト— |
フィールドmodel | 種類string | 要件必須 | 値と制限 voyageai/rerank-3 | デフォルト— |
フィールドprovider | 種類schema | 要件任意 | 値と制限 | デフォルト— |
フィールドquery | 種類string | 要件必須 | 値と制限 | デフォルト— |
フィールドsession_id | 種類string | 要件任意 | 値と制限 | デフォルト— |
フィールドtop_n | 種類integer | 要件任意 | 値と制限 最小値: 1 | デフォルト— |
フィールドtrace | 種類schema | 要件任意 | 値と制限 | デフォルト— |
フィールドuser | 種類string | 要件任意 | 値と制限 | デフォルト— |
フィールドdocuments[].text | 種類string | 要件任意 | 値と制限 | デフォルト— |
フィールドdocuments[].image | 種類string | 要件任意 | 値と制限 | デフォルト— |
入力素材の組み合わせ
text_rerank · 必須: query, documents array with minItems1
メソッドのパラメータとライフサイクル
| パラメータ | 仕様 |
|---|---|
パラメータcontent_type | 仕様application/json |
パラメータrequired | 仕様model, query, documents |
パラメータmaterial_types | 仕様text |
パラメータoptional_controls | 仕様provider, session_id, top_n, trace, user |
パラメータmultimodal_input_binding | 仕様null |
ライフサイクル: synchronous
正確なモデルIDを送信し、ネイティブのレスポンス全体を保持してください。
料金
料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。
- 高速モード
- 未指定 高速モードが選択されている場合
- Flex モード
- 未指定 flex モードが選択されている場合
- 最大推論量
- 未指定 推論量が最大で、調整に既定値(default)を使用する場合
Ailootの料金
設定別の価格
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 料金表 | 課金単位 | 料金 |
|---|---|---|---|
| 設定基本トークン料金 | 料金表基本料金 | 課金単位— | 料金 入力 · 入力トークン — / 1K トークン 出力 · 出力トークン — / 1K トークン 入力 · キャッシュ読み取り — / 1K トークン 入力 · キャッシュ書き込み — / 1K トークン 入力 · キャッシュ書き込み、1時間 — / 1K トークン |
| 設定Ultra | 料金表— | 課金単位/ 1K トークン | 料金 入力 $0.0001 / 1K トークン |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
リクエスト例
Ailoot Ultra · 再ランキング
{
"documents": [
"Paris is the capital of France.",
"Berlin is the capital of Germany."
],
"model": "voyageai/rerank-3",
"query": "What is the capital of France?",
"top_n": 3
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='voyageai/rerank-3'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
結果を受け取って保存
Ailoot Ultra · 再ランキング
json
完了した結果をすべて保存
返された完全なレスポンス、ファイル、コンテンツ部分をすべて保存してください。
実際の結果の各インデックス、有限値のrelevance_score、元の文書オブジェクトはすべて保持されます。インデックスは元の文書配列に対応します。元のJSON全体は保存され、精算後にのみ返されます。
元のレスポンスを確認する場合
元の操作と、完全または部分的な応答を保持してください。POSTを再実行しないでください。
レスポンスのフィールド
| フィールド | 種類 |
|---|---|
フィールドmodel | 種類string |
フィールドid | 種類string |
フィールドprovider | 種類string |
フィールドresults[].index | 種類integer |
フィールドresults[].relevance_score | 種類number |
フィールドresults[].document.text | 種類string |
フィールドresults[].document.image | 種類string |
フィールドusage.search_units | 種類integer |
フィールドusage.total_tokens | 種類integer |
フィールドusage.cost | 種類number |
エラーと次の手順
| レスポンス | 条件 | 次の手順 |
|---|---|---|
レスポンス400 · invalid_request_error | 条件必須フィールド、表現形式、または値が無効です | 次の手順指摘されたリクエストフィールドを修正してください。 |
エイリアス
モデルのエイリアス
Ailoot Ultra voyageai/rerank-3
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
FAQ · VoyageAI by MongoDB: rerank-3
- 利用できる入力と結果は何ですか?
POST /v1/rerank·voyageai/rerank-3:text→rerank- リクエストはどの項目を使用しますか?
POST /v1/rerank·voyageai/rerank-3:documents,model,provider,query,session_id,top_n,trace,user- どの制限が適用されますか?
POST /v1/rerank·voyageai/rerank-3:top_n.minimum:1