diff --git a/journey/troubleshooting/260312_rb8001_memory_chromadb_768_384_dimension_drift.md b/journey/troubleshooting/260312_rb8001_memory_chromadb_768_384_dimension_drift.md new file mode 100644 index 0000000..941eaec --- /dev/null +++ b/journey/troubleshooting/260312_rb8001_memory_chromadb_768_384_dimension_drift.md @@ -0,0 +1,45 @@ +--- +tags: [rb8001, chromadb, memory, embedding, troubleshooting] +--- + +# rb8001 메모리 ChromaDB 768/384 차원 드리프트 + +## 관련 문서 +- [Company X 내부문서 RAG 근거응답 구현 및 시나리오 검증](../worklog/260312_companyx_내부문서_rag_근거응답_구현및시나리오검증.md) +- [Company X 내부문서 RAG 근거응답 현황 리서치](../research/260312_companyx_내부문서_rag_근거응답_현황_리서치.md) +- [ChromaDB 차원 불일치로 RAG 검색 실패](./251122_happybell80_chromadb_dimension_mismatch.md) + +## 문제 +- Company X RAG 근거응답 시나리오는 동작했지만, `rb8001` 사용자 메모리 컬렉션 저장/검색에서 여전히 차원 불일치 에러가 발생합니다. +- 실제 로그: + - `Collection expecting embedding with dimension of 768, got 384` + +## 관찰 사실 +- 현재 런타임 임베딩은 `384d`입니다. +- `skill-rag-file` Company X 컬렉션은 `384d` 기준으로 재구성해 동작 확인했습니다. +- 반면 `rb8001_{user_uuid}_memory` 컬렉션은 과거 `768d` 상태가 남아 있어, 메모리 저장과 최근 대화 검색에서 에러가 반복됩니다. +- 이번 Company X 시나리오에서 `/api/test/router-message`, `/api/message`는 성공했지만, 같은 시점 로그에 메모리 컬렉션 에러가 함께 남았습니다. + +## 영향 +- Company X 근거응답 자체는 막지 않습니다. +- 하지만 사용자 메모리 저장/검색 품질은 저하됩니다. +- 운영 로그에 오류가 계속 쌓여 실제 다른 문제 탐지를 방해할 수 있습니다. + +## 원인 가설 +1. 과거 `768d` 메모리 컬렉션이 남아 있습니다. +2. 현재 `skill-embedding` 런타임은 `384d`를 반환합니다. +3. `rb8001` 메모리 매니저가 기존 컬렉션을 그대로 재사용하면서 조회/삽입 시 차원 충돌이 납니다. + +## 이번 작업에서 확인한 범위 +- `Company X` 전용 RAG 컬렉션: 동작 확인 +- `rb8001` 메모리 컬렉션: 미정비 +- 따라서 이번 이슈는 `Company X RAG 실패`가 아니라 `rb8001 memory layer drift`입니다. + +## 다음 조치 +1. `rb8001_{user_uuid}` 및 `rb8001_{user_uuid}_memory` 컬렉션 차원 현황 조사 +2. 현행 `384d` 기준으로 재생성 또는 마이그레이션 전략 결정 +3. 메모리 컬렉션 재구성 후 `/api/message` 저장/검색 로그 재검증 +4. 로그에서 `dimension mismatch`가 사라졌는지 확인 + +## 상태 +- 열림 diff --git a/journey/troubleshooting/README.md b/journey/troubleshooting/README.md index 6157790..27f69f5 100644 --- a/journey/troubleshooting/README.md +++ b/journey/troubleshooting/README.md @@ -40,3 +40,5 @@ - NAVER WORKS 브리핑 인사이트 앞에 `로빙입니다` 같은 서두가 노출된 문제 기록 - [260311_prompt_db_partial_adoption_and_hardcoded_prompts.md](./260311_prompt_db_partial_adoption_and_hardcoded_prompts.md) - 프롬프트 DB 골격은 있으나 실제 운영 프롬프트 다수가 하드코딩으로 남아 있는 상태 기록 +- [260312_rb8001_memory_chromadb_768_384_dimension_drift.md](./260312_rb8001_memory_chromadb_768_384_dimension_drift.md) + - rb8001 사용자 메모리 컬렉션에 남아 있는 768/384 차원 드리프트와 Company X RAG 검증 시 동시 관찰된 에러 기록