공통 메모리 설계

메모리는 단기와 장기로 분리해서 설계합니다.

​

단기 메모리 (Short-term)

현재 실행 컨텍스트를 유지합니다.

• 범위: 같은 thread_id
• 데이터: 최근 대화, 중간 결과, 도구 호출 이력
• 목적: 현재 태스크 정확도 향상

​

장기 메모리 (Long-term)

세션을 넘어 축적되는 기억입니다.

• 범위: 여러 thread
• 데이터: 사용자 선호, 도메인 힌트, 과거 결정
• 목적: 개인화/일관성

​

프레임워크별 매핑

​

운영 원칙

1. 단기는 짧게 유지(요약/트리밍)
2. 장기는 스키마를 고정
3. PII는 저장 전 마스킹
4. 만료 정책(TTL) 정의

​

학습 완료 기준

• 이 문서의 핵심 개념을 3분 내로 설명할 수 있습니다.
• 현재 프로젝트 기준으로 적용할 범위와 제외 범위를 구분할 수 있습니다.
• 다음 학습 단계에서 필요한 입력(코드/정책/데이터)을 준비할 수 있습니다.

​

실무 적용 체크리스트

• thread_id 규칙을 문서화했습니다.
• 장기 저장 승격 기준과 TTL을 정의했습니다.
• 요약/트리밍 정책을 테스트했습니다.
• PII 마스킹 후 저장하도록 검증했습니다.

​

자주 나는 실수

1. thread_id 경계를 정의하지 않아 사용자 문맥이 섞입니다.
2. 장기 메모리에 임시 데이터를 저장해 조회 품질이 떨어집니다.
3. 요약/TTL 정책이 없어 컨텍스트 비용이 급증합니다.

​

다음 문서

다음: 공통 미들웨어 설계

학습 흐름을 이어서 진행합니다.