docs: close 260323 grounding routing rollback follow-up
This commit is contained in:
parent
c1d9cc288a
commit
c6a7f402b1
@ -1,7 +1,7 @@
|
|||||||
---
|
---
|
||||||
status: closed
|
status: closed
|
||||||
closed_date: 2026-03-21
|
closed_date: 2026-03-21
|
||||||
closed_reason: P0 3건(prefix/threshold/RRF) + P1 2건(청크재분할/라우팅완화) 전부 구현·배포·검증 완료. keyword 0→5건, grounding 5→11, 옐로펀치 MOU top-1.
|
closed_reason: P0 3건(prefix/threshold/RRF) + P1 2건(청크재분할/라우팅완화) 구현·배포·검증 완료. 다만 P1-5(team_id 단독 grounding)는 2026-03-23 마커 기반 진입으로 롤백됨.
|
||||||
---
|
---
|
||||||
|
|
||||||
# 260321 하이브리드 검색 품질 개선 계획
|
# 260321 하이브리드 검색 품질 개선 계획
|
||||||
@ -15,6 +15,7 @@ closed_reason: P0 3건(prefix/threshold/RRF) + P1 2건(청크재분할/라우팅
|
|||||||
|
|
||||||
- [260321 하이브리드 검색 keyword recall=0 및 grounding 실패 원인 확정 리서치](../research/rag/260321_하이브리드검색_keyword_recall0_및_grounding_실패_원인확정_리서치.md)
|
- [260321 하이브리드 검색 keyword recall=0 및 grounding 실패 원인 확정 리서치](../research/rag/260321_하이브리드검색_keyword_recall0_및_grounding_실패_원인확정_리서치.md)
|
||||||
- [260320 로빙 다형식문서 RAG 적용1 계획](./260320_로빙_다형식문서_RAG_적용1_계획.md)
|
- [260320 로빙 다형식문서 RAG 적용1 계획](./260320_로빙_다형식문서_RAG_적용1_계획.md)
|
||||||
|
- [260323 Company X grounding 마커 기반 라우팅 복원 및 fallback 복구 검증 완료](../worklog/260323_companyx_grounding_마커기반라우팅복원_및_fallback복구_검증완료.md)
|
||||||
|
|
||||||
## 원인 → 조치 매핑
|
## 원인 → 조치 매핑
|
||||||
|
|
||||||
@ -66,6 +67,7 @@ closed_reason: P0 3건(prefix/threshold/RRF) + P1 2건(청크재분할/라우팅
|
|||||||
- 따라서 grounding 검색 결과 0건이면 기존처럼 일반 챗봇 경로로 자연 fallback
|
- 따라서 grounding 검색 결과 0건이면 기존처럼 일반 챗봇 경로로 자연 fallback
|
||||||
- **범위 위험**: 일반 대화("점심 뭐 먹을까?")도 검색 API를 태우게 됨. 불필요한 API 호출 + 응답 지연 발생 가능
|
- **범위 위험**: 일반 대화("점심 뭐 먹을까?")도 검색 API를 태우게 됨. 불필요한 API 호출 + 응답 지연 발생 가능
|
||||||
- **롤백 기준**: 배포 후 일반 대화 응답 지연이 1초 이상 증가하거나, grounding 경로 진입률이 80% 이상이면 마커 체크 복원
|
- **롤백 기준**: 배포 후 일반 대화 응답 지연이 1초 이상 증가하거나, grounding 경로 진입률이 80% 이상이면 마커 체크 복원
|
||||||
|
- **후속 이력**: 위 위험이 실제 협업 검토에서 확인되어 2026-03-23 `91b92da`에서 `team_id + marker` 기준으로 롤백됐다. 현재 운영 기준은 이 문서가 아니라 260323 워크로그와 `SKILL.md`, `companyx_grounding_pipeline.md`를 따른다.
|
||||||
|
|
||||||
## 실행 순서
|
## 실행 순서
|
||||||
|
|
||||||
|
|||||||
@ -39,8 +39,6 @@
|
|||||||
- 상태: 열림
|
- 상태: 열림
|
||||||
- [260311_prompt_db_partial_adoption_and_hardcoded_prompts.md](./260311_prompt_db_partial_adoption_and_hardcoded_prompts.md)
|
- [260311_prompt_db_partial_adoption_and_hardcoded_prompts.md](./260311_prompt_db_partial_adoption_and_hardcoded_prompts.md)
|
||||||
- 상태: 열림
|
- 상태: 열림
|
||||||
- [260312_companyx_rag_answer_composition_regression.md](./260312_companyx_rag_answer_composition_regression.md)
|
|
||||||
- 상태: 범위 조정 중
|
|
||||||
- [260312_rb8001_memory_chromadb_768_384_dimension_drift.md](./260312_rb8001_memory_chromadb_768_384_dimension_drift.md)
|
- [260312_rb8001_memory_chromadb_768_384_dimension_drift.md](./260312_rb8001_memory_chromadb_768_384_dimension_drift.md)
|
||||||
- 상태: 열림
|
- 상태: 열림
|
||||||
|
|
||||||
|
|||||||
@ -0,0 +1,49 @@
|
|||||||
|
---
|
||||||
|
type: worklog
|
||||||
|
tags: [worklog, companyx, grounding, routing, fallback, rb8001]
|
||||||
|
work_date: 2026-03-23
|
||||||
|
---
|
||||||
|
|
||||||
|
# 260323 Company X grounding 마커 기반 라우팅 복원 및 fallback 복구 검증 완료
|
||||||
|
|
||||||
|
## 배경
|
||||||
|
|
||||||
|
- `260321_하이브리드검색_품질개선_계획.md`의 P1-5에서 Company X team_id 사용자는 마커 없이도 grounding을 우선 시도하도록 완화했다.
|
||||||
|
- 이후 일반 대화까지 grounding 경로에 과잉 진입할 수 있다는 협업 검토가 나왔고, 23/24 서버 에이전트가 최종적으로 마커 기반 복원에 합의했다.
|
||||||
|
|
||||||
|
## 조치
|
||||||
|
|
||||||
|
1. `rb8001` `91b92da`
|
||||||
|
- `should_handle_companyx_grounding()`를 `team_id + marker(intent/domain)` 기준으로 복원
|
||||||
|
- `try_companyx_grounding()`에서 검색 결과 0건이면 `None`을 반환해 일반 스킬 경로로 fallback 복구
|
||||||
|
2. `DOCS` `c1d9cc2`
|
||||||
|
- `skills/companyx-rag/SKILL.md` Trigger를 마커 기반 진입으로 정렬
|
||||||
|
- `workflow/03_rag/companyx_grounding_pipeline.md` 처리 순서와 실패 분기를 현재 코드 기준으로 정렬
|
||||||
|
|
||||||
|
## 검증
|
||||||
|
|
||||||
|
- 코드 실물 확인:
|
||||||
|
- `rb8001` HEAD `91b92da`
|
||||||
|
- `should_handle_companyx_grounding()`는 `team_id == COMPANYX_TEAM_ID`이면서 marker 매칭일 때만 grounding 진입
|
||||||
|
- `try_companyx_grounding()`는 `top_results` 0건일 때 `None` 반환
|
||||||
|
- 문서 실물 확인:
|
||||||
|
- `DOCS` HEAD `c1d9cc2`
|
||||||
|
- `SKILL.md`, `companyx_grounding_pipeline.md`가 코드 기준과 일치
|
||||||
|
- 통합 테스트 완료 보고:
|
||||||
|
- `[24]_260323_통합테스트_완료_24codex.md`
|
||||||
|
- Company X 사용자 + marker 있음 → grounding 진입 PASS
|
||||||
|
- Company X 사용자 + marker 없음 → 일반 경로 PASS
|
||||||
|
- 비 Company X 사용자 + marker 있음 → 일반 경로 PASS
|
||||||
|
- 검색 0건 fallback 분기 → patch 기반 통합 호출 PASS
|
||||||
|
|
||||||
|
## 결과
|
||||||
|
|
||||||
|
- 현재 운영 기준은 `team_id 단독 진입`이 아니라 `team_id + marker`다.
|
||||||
|
- 일반 질문은 grounding에 과잉 진입하지 않고, 문서 질문만 grounding으로 들어간다.
|
||||||
|
- 문서 검색 결과가 0건이면 grounding 실패 응답으로 고정하지 않고 일반 경로로 되돌린다.
|
||||||
|
|
||||||
|
## 관련 문서
|
||||||
|
|
||||||
|
- [260321 하이브리드 검색 품질 개선 계획](../plans/260321_하이브리드검색_품질개선_계획.md)
|
||||||
|
- [260322 검색 품질 2차 — 파일명 보조 검색 + 대화 맥락 전달](../plans/260322_검색품질2차_파일명보조검색_대화맥락전달_계획.md)
|
||||||
|
- [Company X RAG LLM 판단 과보수 + 대화 맥락 미연결](../troubleshooting/260322_companyx_rag_LLM판단보수_대화맥락미연결.md)
|
||||||
Loading…
x
Reference in New Issue
Block a user