3.7 KiB
3.7 KiB
Milestone: Retrieve와 Answer Pipeline
위치
- Roadmap: ROADMAP.md
- Phase: PHASE.md
목표
활성 release의 versioned policy를 해석해 retrieval, rerank, context assembly와 generation을 실행한다. JSON과 SSE 모두 release, evidence, trace identity와 일관된 오류를 반환하고 특정 provider 장애를 공개 계약으로 정규화한다.
상태
[계획]
구현 잠금
- 상태: 해제
- SDD: 필요
- SDD 문서: SDD.md
- SDD 사유: 공개 OpenAPI·SSE, provider 호출 순서, trace retention과 failure mapping 계약을 변경한다.
- 잠금 해제 조건:
- SDD 잠금이 해제되어 있다.
- SDD 사용자 리뷰가 없거나 승인/해결되었다.
- Acceptance Scenario가 Milestone 기능 Task와 연결되어 있다.
- Evidence Map이 완료 시 Roadmap Completion과 최종 검증 evidence로 검증 가능하게 연결되어 있다.
- 결정 필요: 없음
범위
- project, knowledge base와 release alias 해석
- query embedding, retrieval backend search, filter와 top-k
- rerank, context budget, evidence·citation assembly
- generation provider와 JSON·SSE answer
- trace identity, release identity, usage·latency와 만료 보존
- provider timeout, unavailable, invalid policy와 partial stream 오류
기능
Epic: [retrieve] Versioned 검색
동일 release와 요청이 동일한 정책 경로를 사용하도록 온라인 검색을 고정한다.
- [release-resolution] 요청마다 active release를 해석하고 response와 trace에 release id·alias·version을 포함한다.
- [retrieval-policy] embedding, filter, backend search와 top-k를 release policy와 capability에 따라 실행한다.
- [rerank-context] rerank와 context budget을 적용하고 rank, score, citation과 metadata를 안정된 evidence로 반환한다.
Epic: [answer] 생성과 Streaming
검색 evidence를 보존하면서 non-streaming과 streaming 응답 의미를 일치시킨다.
- [generation] generation provider에 query, evidence와 versioned policy를 전달하고 answer·usage를 반환한다.
- [sse-contract] metadata, evidence, delta, completed, error SSE event를 순서 있게 전송하고 JSON 오류 의미와 대응시킨다.
- [trace-retention] query·answer 원문 저장은 policy에 따라 선택하고 모든 저장 trace에 expiry를 강제한다.
- [provider-failures] timeout, unavailable, capability mismatch와 partial stream failure를 공개 오류 코드로 정규화한다. 검증: fake provider matrix와 HTTP/SSE contract test가 통과한다.
완료 리뷰
- 상태: 없음
- 요청일: 없음
- 완료 근거: 모든 기능 Task와 검증 충족 및 구현 잠금 해제 여부를 완료 시 기록한다.
- 검토 항목: OpenAPI·handler drift, JSON/SSE parity, release evidence와 trace expiry
- agent-ui 상태 반영: 해당 없음
- 리뷰 코멘트: 없음
범위 제외
- request 시점의 index 작성과 release 승격
- 특정 vector DB 또는 model SDK 타입의 공개 노출
- 무기한 raw query·answer 보존
작업 컨텍스트
- 관련 경로:
packages/go/rag/,packages/go/integration/,api/openapi/,db/queries/traces.sql - 표준선(선택): active release read-only, evidence-first response, JSON/SSE semantic parity
- 선행 작업: Index 게시와 Release 수명주기, Integration 카탈로그와 Secret 경계
- 후속 작업: 평가와 승격 Gate
- 확인 필요: 없음