문서

검색 리플레이

search_id로 과거 검색을 재실행 — 평가 / 회귀 테스트 워크플로우용.

리플레이 API는 이전 검색을 다른 파라미터로 재실행하고 결과를 비교합니다. 랭킹 변경 A/B 평가, rerank 모델 업그레이드 회귀 테스트, 더 엄격한 필터로 결과 재구성 등에 유용합니다.

요청

bashPOST /v1/search/replay

필드	타입	기본값	설명
`search_id`	string	--	원래 `/v1/buckets/{id}/search` 호출이 반환한 ID.
`override`	object	null	선택. 재실행에 적용될 필드: `top_k`, `filter`, `min_score`, `mode`, `rerank`, `expand_neighbors`.
`include_original`	bool	false	캡처된 첫 실행 결과를 응답에 포함.

예시

bashcurl -X POST https://api.schift.io/v1/search/replay \
  -H "Authorization: Bearer $SCHIFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "search_id": "search_abc123",
    "override": {"min_score": 0.7, "rerank": true},
    "include_original": true
  }'

Diff 메트릭

added — 재실행에서 새로 등장한 ID.
removed — 원래 결과에서 떨어진 ID.
shared — 양쪽에 모두 있는 ID 수.
rank_correlation — 공유 ID에 대한 Spearman 상관계수 (1.0=동일, -1.0=역순). 공유 ID가 2개 미만이면 null.

제약

원본 요청 페이로드(filter, top_k 등)는 아직 영속화하지 않습니다. 따라서 override 없이 리플레이하면 정확히 동일한 설정이 아니라 기본 검색 파라미터로 실행됩니다.