LangGraph namespace
2026년 7월 16일
LangGraph namespace
namespace는 LangGraph Store에서 장기 기억을 분류하는 이름 공간이다.
LangGraph thread_id가 대화 세션을 구분한다면, namespace는 저장된 지식의 소속을 구분한다.
왜 필요한가
Store에는 여러 사용자, 여러 프로젝트, 여러 도메인의 기억이 함께 들어갈 수 있다.
namespace가 없으면 기억이 섞인다.
구조
Mermaid스크롤로 확대 · 드래그로 이동
예시
Python
이 namespace는 user-1의 장기 기억을 의미한다.
프로젝트 기억은 이렇게 나눌 수 있다.
Python
thread_id와 비교
| 구분 | LangGraph thread_id | namespace |
|---|---|---|
| 대상 | Checkpointer | Store |
| 목적 | 대화 흐름 유지 | 장기 기억 분류 |
| 수명 | 같은 대화 중심 | 여러 대화에서 재사용 |
| 예시 | "session-a" | ("user_memory", "user-1") |
감각적으로 이해하기
thread_id는 채팅방 번호에 가깝다.
namespace는 기억 보관함의 폴더명에 가깝다.