docs: close 260323 grounding routing rollback follow-up

This commit is contained in:
happybell80 2026-03-23 00:53:21 +09:00
parent c1d9cc288a
commit c6a7f402b1
3 changed files with 52 additions and 3 deletions

View File

@ -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`를 따른다.
## 실행 순서 ## 실행 순서

View File

@ -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)
- 상태: 열림 - 상태: 열림

View File

@ -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)