제3장 · 사용자 메모리와 지식 베이스¶
에이전트가 세션을 넘어 사용자를 기억하고 외부 지식에 접근할 수 있게 합니다. 사용자 메모리 시스템과 기본 RAG 파이프라인, 평면 텍스트를 넘어선 지식 구성·검색 방식(구조화 색인, 지식 그래프 등)을 다룹니다.
← 한국어 메인 README로 돌아가기 · 📖 제3장 본문 읽기
연계 프로젝트¶
| 실험 | 프로젝트 | 유형 | 설명 |
|---|---|---|---|
| 3-1, 3-2 | user-memory | ✅ | 장기 사용자 메모리 시스템을 구축합니다. 에이전트가 사용자의 선호와 과거 상호작용을 기억해 개인화된 서비스를 제공할 수 있습니다. |
| 3-1, 6-3 | user-memory-evaluation | ✅ | 3계층 사용자 메모리 평가 세트입니다. 실험 6-3에서는 4단계 다차원 루브릭, 차원별 증거, 환각 발생 시 즉시 탈락하는 조건을 다룹니다. |
| 3-2 | mem0 · memobase | ✅ | 두 오픈 소스 메모리 프레임워크인 mem0와 Memobase로 각각 사용자 메모리를 구현합니다. 실험 3-2 ‘메모리 전략 비교’의 비교 구현으로서, 서로 다른 메모리 솔루션의 추출 형식과 답변 품질을 나란히 비교할 수 있습니다. |
| 3-3 | log-sanitization | ✅ | 로컬 Ollama 모델로 비밀 정보와 개인정보(PII)를 탐지·가림 처리하면서 디버깅 가치는 보존하는 지능형 로그 정제 도구입니다. |
| 3-4 | dense-embedding | ✅ | 벡터 유사도 검색 서비스를 만들고 트리 기반 ANNOY와 그래프 기반 HNSW 근사 최근접 이웃 색인을 비교합니다. 성능, 메모리 사용량, 갱신 가능성 측면에서 색인 전략마다 어떤 절충이 필요한지 보여 줍니다. |
| 3-5 | sparse-embedding | ✅ | BM25 알고리즘을 바탕으로 희소 벡터 검색 엔진을 처음부터 구현합니다. 풍부한 로그와 시각화 인터페이스를 통해 용어 빈도 가중치 계산, 역색인 원리 등 검색 엔진의 내부 동작을 이해할 수 있습니다. |
| 3-6 | retrieval-pipeline | ✅ | 밀집 검색, 희소 검색, 신경망 재순위화를 결합한 완전한 검색 파이프라인을 구축합니다. 세심하게 설계한 테스트 사례로 여러 상황에서 하이브리드 검색 방식이 어떻게 서로의 단점을 보완하는지 체계적으로 보여 줍니다. |
| 3-7 | multimodal-agent | ✅ | 네이티브 멀티모달 처리, 텍스트 추출, 도구 기반 분석이라는 세 가지 멀티모달 처리 전략을 비교합니다. 하나의 프레임워크에서 구성 요소 제거 실험을 수행해 각 기술 경로의 충실도, 비용, 유연성 사이 절충을 드러냅니다. |
| 3-8 | structured-index | ✅ | 재귀 요약을 이용한 계층형 트리 RAPTOR와 지식 그래프 GraphRAG라는 두 가지 구조화 색인 방식을 구현하고 비교합니다. |
| 3-9 | agentic-rag | ✅ | 전통적인 비에이전트형 RAG와 Agentic RAG의 성능을 비교합니다. ReAct 패턴을 사용하는 에이전트가 반복적인 정보 검색을 주도해 복잡한 사법 질의응답에서 답변 품질을 크게 높이는 과정을 보여 줍니다. |
| 3-10 | agentic-rag-for-user-memory | ✅ | Agentic RAG 프레임워크를 사용자 대화 기록 관리에 적용합니다. 여러 차례 반복 검색하는 능력을 활용해 세션을 넘나드는 메모리 검색을 처리하고, 기본 회상과 세션 간 검색 기능을 구현합니다. |
| 3-11 | contextual-retrieval | ✅ | Anthropic이 제안한 컨텍스트 인식 검색 기법을 구현합니다. 텍스트 청크마다 핵심 맥락을 담은 접두 요약을 생성해 전통적인 청킹의 컨텍스트 손실 문제를 해결하고 검색 실패율을 49~67% 줄입니다. |
| 3-12 | contextual-retrieval-for-user-memory | ✅ | 컨텍스트 인식 검색 기법을 사용자 메모리 구축에 적용합니다. 고급 JSON 카드와 컨텍스트 인식 RAG를 결합해 2계층 메모리 아키텍처를 만들고, 더 높은 수준의 능동적 서비스 역량을 구현합니다. |
| 3-13 | structured-knowledge-extraction | ✅ | 사법 판례를 예로 들어 ‘상향식 요인 발견 → 사건 프로토타입 군집화 → 대화형 자문 에이전트’의 3단계 파이프라인을 구현합니다. 미리 정한 경직된 필드 없이 LLM이 많은 사건에서 요인을 스스로 발견해 모듈형 스키마(핵심 요인 + 혐의별 확장 요인)로 정리합니다. 이어 사건을 여러 프로토타입으로 군집화하고 각 프로토타입에서 요인별 중요도를 계산합니다. 에이전트는 새 사건의 사실관계를 가장 유사한 프로토타입에 대응시키고, 요인 중요도에 따라 빠진 정보를 질문한 뒤 근거 기반 조언을 제공합니다(법률 면책 고지 포함). |
프로젝트 유형¶
| 아이콘 | 유형 | 의미 |
|---|---|---|
| ✅ | 독립 실행 | 전체 코드가 이 저장소에 있으며, API 키를 설정하면 실행할 수 있습니다. |
| 📖 | 재현 가이드 | 외부 저장소를 git clone해야 하는 상세 안내 문서입니다. |
| 🚧 | 설계 문서 | 아키텍처와 구현 계획만 있으며, 실행 가능한 코드는 아직 작성 중입니다. |