Qwen: Qwen3 Rerank

Qwen3 Rerankは、提示したクエリと順位付けの指示に照らして候補テキストを評価します。設定された正確なモデル指定はqwen3-rerankです。検索や文書選択のために、提示された候補を並べる役割を担います。リクエストではクエリ、指示、候補の記述を一緒に保持し、関連度の判断を入力にさかのぼって確認できるようにします。

documentsは文字列の配列として用意し、各要素に候補の記述を一つ入れます。配列の各位置から、独自の文書識別子、タイトル、出典の位置への対応表を別途保持します。これにより、文書化されていない識別子オブジェクトを文字列配列に追加せずに、順位付きの結果を元の記述へ結び直せます。サポート向けの検索なら、候補は製品ガイドからすでに取得した関連セクションなどです。クエリには、ユーザーが実際に必要としている情報を記します。

文書化されたリクエストではmodel、documents、query、top_n、instructが必須です。queryとinstructは文字列で、top_nは明示的に指定する整数です。公開されている例では、三つの候補テキスト、top_n=2、ウェブ検索の質問に答える関連記述を取得するための指示を使っています。順位付けで重視する関係はinstructに記し、実際の質問はquery、評価対象の資料はdocumentsに入れます。

操作ガイドは最大入力長を30Kとしています。関連度を判断するために必要なテキストに候補の記述を絞り、意味が変わる場合は見出しや前後のコンテキストを残します。元の文書で選択された記述を確認できるよう、出典の境界を保ちます。正確なリクエスト仕様と必須フィールドを、入力を用意する際の基準とします。

返される構造化結果には、indexとrelevance_scoreを持つresultsエントリが含まれます。indexは順位付き結果リスト内の位置ではなく、元のdocuments配列内での候補の位置を指します。返された順序を保ち、各indexを使って対応する入力テキストを取得します。返された結果をすべて保持し、アプリケーションが選択された候補とスコアをまとめて確認できるようにします。

model、応答のid、usage.total_tokensを含む完全なJSONレスポンスを保持します。返却結果に文書テキストが含まれない場合もあるため、インデックスを処理する際に元の候補配列を使えるようにしておきます。関連度スコアと報告された使用量には別々の役割があり、スコアは順位付けの結果、使用量はその操作で報告された量を表します。どちらも、後の回答の根拠になる元の記述の代わりにはなりません。

検索ワークフローでは、この順位付けを使って、次の段階で確認や引用を行う記述を選びます。内容を根拠として提示する前に、選択した記述をクエリと指示に照らして確認します。結果リストで上位にあることは、確認すべき候補であることを示します。アプリケーションが最終的に返す回答は、実際のテキストとその出典識別子に結び付けておく必要があります。

代表的なクエリと、アプリケーションが使う候補集合で結果を確認します。インデックスが意図した元のテキストに対応すること、順序が提示した指示に役立つこと、選択した記述が質問に答えることを確認します。正確なモデル指定、クエリ、指示、候補の対応表、完全なレスポンスを一緒に保持し、次の検索や文書処理で再利用できる関連情報の選択記録を作成します。