언제 도입하나
- 재방문 사용자에게 개인화가 필요할 때
- 팀 공통 정책을 계속 재사용해야 할 때
- 반복 작업에서 이전 결정을 재활용할 때
최소 데이터 모델
| 항목 | 예시 |
|---|---|
| namespace | tenant-a:user-100 |
| key | writing_style |
| value | {"tone":"concise","lang":"ko"} |
| updated_at | ISO datetime |
운영 원칙
- 장기 저장 대상만 명시적으로 승격합니다.
- TTL 또는 정기 정리 정책을 둡니다.
- PII는 암호화 또는 마스킹 후 저장합니다.
- 읽기 실패 시 기본값으로 안전하게 폴백합니다.
단기/장기 분리 기준
- 단기: 현재 작업에만 필요한 임시 문맥
- 장기: 다음 세션에도 가치가 있는 안정 정보
LangGraph 메모리 상세
Store API 기반 구현은 이 문서에서 이어서 다룹니다.
실무 적용 체크리스트
- thread_id 규칙을 문서화했습니다.
- 장기 저장 승격 기준과 TTL을 정의했습니다.
- 요약/트리밍 정책을 테스트했습니다.
- PII 마스킹 후 저장하도록 검증했습니다.
자주 나는 실수
- thread_id 경계를 정의하지 않아 사용자 문맥이 섞입니다.
- 장기 메모리에 임시 데이터를 저장해 조회 품질이 떨어집니다.
- 요약/TTL 정책이 없어 컨텍스트 비용이 급증합니다.
다음 문서
다음: LangChain 도구 연동
학습 흐름을 이어서 진행합니다.
장기 메모리 최소 운영 예시
- 사용자 선호: 말투, 출력 길이, 언어
- 팀 정책: 금지 표현, 필수 근거 형식
- 작업 힌트: 반복되는 도메인 규칙