Checkpointer 통합

Checkpointer 통합 (LangGraph 영속성)

에이전트가 이전 대화 내용을 기억하고 이어서 작업하려면 상태를 어딘가에 저장하고 복원해야 해요. LangGraph에서 이 '영속성(persistence)'을 담당하는 핵심 요소가 바로 checkpointer예요. 이 페이지는 LangChain Python에서 사용할 수 있는 checkpointer 백엔드 통합 목록을 한눈에 정리해 줘요. 인메모리부터 PostgreSQL, MongoDB까지 상황에 맞는 백엔드를 고르면 되고, 커스텀 스토리지 백엔드용 checkpointer를 직접 만드는 방법은 별도 가이드에서 다룰게요.

출처: 공식문서

사용 가능한 Checkpointer 통합

체크포인터는 LangGraph에서 영속성을 가능하게 해서, 에이전트가 상호작용 사이에 상태를 저장하고 재개할 수 있게 도와줘요. 아래 표는 지원되는 백엔드와 해당 패키지, 소스 저장소를 정리한 거예요.

백엔드 패키지 소스
In-memory langgraph-checkpoint langchain-ai/langgraph
SQLite langgraph-checkpoint-sqlite langchain-ai/langgraph
PostgreSQL langgraph-checkpoint-postgres langchain-ai/langgraph
AWS (DynamoDB, Bedrock, Valkey) langgraph-checkpoint-aws langchain-ai/langchain-aws
MongoDB langgraph-checkpoint-mongodb langchain-ai/langchain-mongodb
Azure Cosmos DB NoSQL langchain-azure-cosmosdb langchain-ai/langchain-azure
Redis langgraph-checkpoint-redis redis-developer/langgraph-redis
Cockroach DB langchain-cockroachdb cockroachdb/langchain-cockroachdb
Aerospike langgraph-checkpoint-aerospike aerospike-community/aerospike-langgraph
ScyllaDB langgraph-checkpoint-scylladb scylladb/langchain-scylladb
Tigris langgraph-checkpoint-tigris tigrisdata/tigris-langgraph
TypeDB langgraph-checkpoint-typedb typedb/langgraph-checkpoint-typedb
Inspeximus langgraph-checkpoint-inspeximus DanceNitra/inspeximus
Supabase langgraph-checkpoint-supabase Tghez/langgraph-checkpoint-supabase

개발 단계에선 인메모리로 시작해도 좋지만, 프로덕션에서는 스레드 간에 상태가 보존되도록 PostgreSQL이나 MongoDB처럼 영속성을 가진 백엔드를 고르는 걸 추천해요. 커스텀 스토리지 백엔드에 맞는 checkpointer를 직접 구현하고 싶다면 Build a custom checkpointer 가이드를 참고하세요.

더 알아보기 (Learn more)