RAG 検索とチューニング
コマンドやチャットが Space を使用する場合、Rephlo はすべてのドキュメントを無条件にプロンプトへ詰め込むわけではありません。代わりに、リクエストに最も関連性の高い箇所を**検索（retrieve）**し、それだけを注入します。この手法は Retrieval-Augmented Generation（RAG） と呼ばれています。RAG Retrieval 設定では、この検索をどの程度積極的、あるいは寛容にするかを調整できます。
このセクションは Settings → General の下部にあります。
なぜ検索をチューニングするのか
検索はバランスの取り方が重要です。
- 厳しすぎると、Rephlo が有用なコンテキストを取りこぼし、回答が薄くなることがあります。
- 緩すぎると、関連性の低いテキストまで取り込んでしまい、トークンを無駄にしたり、ノイズを増やしたりすることがあります。
デフォルト設定はほとんどの方にとって適切に機能します。チューニングが役立つのは、非常に大きい、非常に専門的、あるいはほぼ重複したコンテンツが多いといった特殊な Space を使っていて、バランスを調整したい場合です。
Basic と Advanced
モードは2つあります。ほとんどのユーザーは Basic だけで十分です。
Basic モード（デフォルト）
1つの厳格さプロファイルを選ぶだけで、Rephlo が適切な値のセットを自動的に適用します。
| プロファイル | 動作 |
|---|---|
| Very Lenient | 広く検索します — より多くのコンテキストを含める方向を優先します。 |
| Lenient | やや緩めの検索です。 |
| Balanced | デフォルト — ほとんどの Space にとって良いバランスです。 |
| Strict | より厳格 — 明確に関連性の高い箇所のみです。 |
| Strictest | 最も選別的 — 確信度が最も高い一致のみです。 |
プロファイルをクリックするだけで、変更は自動的に保存されます。
Advanced モード
Advanced を切り替えると、基盤となるパラメータを直接編集できます。切り替えると、現在のプロファイルから値が事前入力されるため、適切な出発点から始められます。利用できるコントロールは次のとおりです。
- Similarity floor（類似度の下限） — 箇所が検討対象となるために超えなければならない最小の関連性スコアです。
- Selected-ratio cutoff（選択比率カットオフ） — 候補プールのうちどれだけの割合を残すかです。
- High-confidence threshold（高確信度しきい値） — 一致を明確に関連性が高いと判断する基準です。
- Minimum chunks（最小チャンク数） — 検索結果が少なくなりすぎないようにする下限です。
- Minimum Space size（トークン単位の最小 Space サイズ） — Space をまるごと送信するのではなく検索 対象とするかどうかの境界となるしきい値です（デフォルト 4,000）。これは Smart Search が使う分岐点です。この値以下では Rephlo が Space 全体を送信し、これを超えると最も関連性の高い部分のみを検索して取得します。より大きな Space も全体をスキャンし続けたい場合は、この値を引き上げてください。
- Command context budget（トークン単位のコマンドコンテキスト予算） — コマンドが使用できる検索コンテキストのトークン数です。デフォルト 4,000。v1.4.0 で 2,500 から引き上げられたため、コマンドはデフォルトでより多くのドキュメント内容を参照できるようになりました — チャットと同じ予算です。
- Chat context budget（トークン単位のチャットコンテキスト予算） — チャットが使用できる検索コンテキストのトークン数です。デフォルト 4,000。
- Large-Space command guard（トークン単位の大規模 Space コマンドガード） — デフォルト 10,000。このサイズを超えると、Rephlo は Space 全体を送信する前にコマンドを絞り込むよう促します。
- Inject-All Ceiling（トークン単位の全件注入上限） — デフォルト 50,000。フォールバックとして Space 全体を送信する際に注入できる量の上限を、Space の実際のサイズにかかわらず設定します。
トークン予算は、安全な範囲と実際にお使いのプロバイダーが処理できる範囲に自動的にクランプされるため、リクエストを壊すような値を設定することはできません。
保存とリセ ット
- 自動保存 — Settings の他の項目と同様、変更はすぐに保存されます。個別の Save ボタンはありません。
- Reset to Defaults — 工場出荷時のデフォルトに戻します。Basic モードかつ Balanced プロファイルです。
万一お使いの端末で検索チューニングが利用できない場合、Rephlo は静かに組み込みのデフォルト設定にフォールバックします — Space は引き続き機能します。
データモードとの関係
RAG 検索は、データモードにかかわらずすべての Space に適用され、常に Space の生チャンクに対して検索を行います。Minimum Space size の下限を上回る 🗜️ Compact な Space でも、通常のリクエストでは AI による全体要約ではなく、関連性の高い検索済みの箇所が渡されます。データモードが影響するのはフォールバック時のみです — Minimum Space size 以下の Space、または確信度の高い一致がない場合です。この場合、🔍 Smart Search の Space は各ファイルの生テキスト全体を無料で送信し、🗜️ Compact の Space は各ファイルの AI 要約を送信します（この要約の作成には credit が必要です）。全体像については、Data Modes & Compaction をご覧ください。