LangGraph thread_id

thread_id는 LangGraph에서 하나의 대화 흐름을 구분하는 세션 ID다.

LangGraph Checkpointer는 thread_id를 기준으로 어떤 대화 상태를 이어갈지 판단한다.

왜 필요한가

LLM은 기본적으로 이전 실행을 기억하지 않는다.

그래서 LangGraph는 thread_id를 통해 "이 요청이 어느 대화의 다음 턴인지"를 구분한다.

구조

Mermaid스크롤로 확대 · 드래그로 이동

예시

Python

같은 thread_id를 쓰면 checkpointer가 이전 State를 찾아 이어준다.

다른 thread_id를 쓰면?

Python

A와 B는 서로 다른 대화다.

Mermaid스크롤로 확대 · 드래그로 이동

그래서 A에서 말한 내용을 B가 자동으로 기억하지 않는다.

thread_id와 namespace 차이

구분	`thread_id`	LangGraph namespace
쓰는 곳	Checkpointer	Store
목적	같은 대화 이어가기	장기 기억 분류
예시	`session-1`	`("user_memory", "user-1")`
질문	"이 대화의 다음 턴인가?"	"어느 기억 저장소에 넣을까?"

LangGraph thread_id

thread_id는 LangGraph에서 하나의 대화 흐름을 구분하는 세션 ID다.

LangGraph Checkpointer는 thread_id를 기준으로 어떤 대화 상태를 이어갈지 판단한다.

왜 필요한가

LLM은 기본적으로 이전 실행을 기억하지 않는다.

그래서 LangGraph는 thread_id를 통해 "이 요청이 어느 대화의 다음 턴인지"를 구분한다.

구조

Mermaid스크롤로 확대 · 드래그로 이동

예시

Python
config = {"configurable": {"thread_id": "user-1-session-1"}}

graph.invoke(
    {"messages": "내 이름은 철수야"},
    config=config,
)

graph.invoke(
    {"messages": "내 이름이 뭐라고 했지?"},
    config=config,
)

같은 thread_id를 쓰면 checkpointer가 이전 State를 찾아 이어준다.

다른 thread_id를 쓰면?

Python
config_a = {"configurable": {"thread_id": "A"}}
config_b = {"configurable": {"thread_id": "B"}}

A와 B는 서로 다른 대화다.

Mermaid스크롤로 확대 · 드래그로 이동

그래서 A에서 말한 내용을 B가 자동으로 기억하지 않는다.

thread_id와 namespace 차이

구분	`thread_id`	LangGraph namespace
쓰는 곳	Checkpointer	Store
목적	같은 대화 이어가기	장기 기억 분류
예시	`session-1`	`("user_memory", "user-1")`
질문	"이 대화의 다음 턴인가?"	"어느 기억 저장소에 넣을까?"

LangGraph thread_id

LangGraph thread_id

왜 필요한가

구조

예시

다른 thread_id를 쓰면?

thread_id와 namespace 차이

관련

Synapse Map Insight

LangGraph thread_id

LangGraph thread_id

왜 필요한가

구조

예시

다른 thread_id를 쓰면?

thread_id와 namespace 차이

관련

Synapse Map Insight