クエリ書き換えは、AI Search パイプラインの任意ステップです。フォローアップクエリの検索品質を上げます。Search と Chat Completions の両方のリクエストに適用されます。
ユーザーの質問の言い回しは、ドキュメントの書き方と一致しないことがあります。クエリ書き換えは、次の方法でこの差を埋めます。
- くだけた、または曖昧なクエリを、正確で情報量の多い表現に言い換える
- 同義語や関連キーワードを追加する
- つなぎ言葉や関係のない詳細を取り除く
- 以前のメッセージを参照するフォローアップクエリを解決する（例: 「それについてもっと教えて」を、会話履歴に基づく具体的なクエリにする）
これにより検索の一致がより関連したものになり、結果と生成応答の精度が上がります。
クエリ書き換えには messages 形式が必要で、query 形式では適用されません。最初のメッセージは常にそのまま使われます。フォローアップクエリでは、AI Search が会話履歴、最新のユーザーメッセージ、クエリ書き換えのシステムプロンプト を、設定済みの LLM へ送ります。書き換えたクエリを埋め込み、検索に使います。
最初のメッセージ: What is Cloudflare Workers?
（そのまま使い、書き換えません）
フォローアップメッセージ: How do I deploy one?
書き換えたクエリ: deploy Cloudflare Worker getting started
フォローアップの "How do I deploy one?" は、単独では曖昧です。クエリ書き換えは会話の文脈を使い、"one" が Cloudflare Worker を指すと理解します。クエリの書き換え方は、クエリ書き換えのシステムプロンプト に依存します。
クエリ書き換えを有効にすると、クエリパイプラインに LLM 呼び出しが 1 回追加されるため、レイテンシが増えることがあります。