範囲を決めた検索

例のコレクションに一つの質問をし、引用か、明示的な不一致を要求します。手を動かす時間は約 25 分です。セマンティックと回答のプロバイダ時間は別です。

目的

ローカル検索、セマンティック検索、根拠付き回答を分けられます。レベルは、セマンティックと回答のために agent:run を持つ編集者です。モードは保存型で、コレクションは Indexed です。画面は 検索と回答 です。下の HTTP は別経路で、黙って混ぜません。

前提

collection:read と document:read。セマンティックモードと /search/answer には加えて agent:run が必要です。検索の既定モードは local で、プロバイダを呼びません。

サンプル

質問: How many days is the Harbor Sample delivery window? 成功の形: 状態 grounded、短い回答、抜粋に 14 days を含む引用。不足の形: 質問を支えない参照を確認したとき、または中断したとき、状態 insufficient_evidence。

手順

1. コレクションの Search タブで、検索のみに質問します。順位付きチャンクが返り、回答は書きません。
2. HTTP では mode を local または semantic にして POST /api/w/{workspaceId}/search を送ります。セマンティックは、プロバイダ呼び出しの前に agent:run を再び確認します。
3. 使う検索根拠から evidenceRef を取ります。今の抜粋が要るときは POST /api/w/{workspaceId}/search/evidence で読み戻します。
4. confirmed: true とその参照で POST /api/w/{workspaceId}/search/answer を送ります。confirmed は真そのものです。偽はスキーマが拒みます。
5. 進行中の回答は HTTP を中断して止めます。本体は insufficient_evidence と null の回答で戻ります。

フィールド

例

curl -sS -X POST "$BUNDATA_ORIGIN/api/w/$WORKSPACE_ID/search" \
  -H "Authorization: Bearer $BUNDATA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"How many days is the Harbor Sample delivery window?","mode":"local","limit":5}'

{"query":"How many days is the Harbor Sample delivery window?","confirmed":true,"evidenceRefs":["paste-the-evidence-ref-from-search"]}

回答の URL は /api/w/{workspaceId}/search/answer です。他のワークスペースの参照は送りません。

回復

source_changed または SEARCH_EVIDENCE_STALE は、Bite が動いたか期限切れです。検索し直し、新しい参照を確認します。昨日の参照は再利用しません。セマンティックの 403 は agent:run が無いことです。引用の無いプロバイダの文は成功ではありません。unsupportedAspects は、根拠が覆わなかった部分です。

制限

コレクション画面のコンテキストポリシーは、次の画面上の実行を調整します。再埋め込みはせず、/search の本体でもありません。Eval Studio の点数は別の製品領域です。この手順はそれを呼びません。

確認

成功: grounded と、14 日を含む引用の抜粋。失敗: 中断、または窓に触れない参照は、insufficient_evidence と null の回答を返します。