Un checkpointer salvează un instantaneu al stării grafului la fiecare super-pas, organizat pe fire de execuție (thread_id). Pe el se sprijină memoria pe termen scurt a conversației, human-in-the-loop, time travel și reluarea după erori. Documentația cere ca la orice apel al unui graf cu checkpointer să dai thread_id în config["configurable"]; un thread_id nou pornește cu stare goală.
Implementări: InMemorySaver (din langgraph-checkpoint, inclus cu LangGraph; MemorySaver este numele vechi, păstrat ca alias) ține totul în RAM și pierde datele la repornire. SqliteSaver (langgraph-checkpoint-sqlite) este pentru experimente și lucru local. PostgresSaver (langgraph-checkpoint-postgres) și MongoDBSaver (langgraph-checkpoint-mongodb) sunt indicate pentru producție. Pentru cod asincron există AsyncSqliteSaver și AsyncPostgresSaver.
graph.get_state(config) întoarce un StateSnapshot cu ultimul checkpoint (values, next, config), iar get_state_history(config) toate checkpoint-urile firului, cu cel mai recent primul. Checkpointer-ul ține starea unui singur fir; datele comune mai multor conversații (preferințe, fapte) merg într-un store, de exemplu InMemoryStore, dat la compile(store=...).
Concepte cheie și caracteristici
| Concept / Parametru | Descriere practică |
|---|---|
compile(checkpointer=...) |
Activează persistența grafului. |
thread_id |
Identificatorul firului, în config["configurable"]. Obligatoriu la apelurile pe un graf cu checkpointer. |
checkpoint_id |
Identifică un checkpoint anume dintr-un fir; folosit la time travel. |
get_state(config) |
Ultimul StateSnapshot al firului. |
get_state_history(config) |
Toate checkpoint-urile firului, cel mai recent primul. |
InMemorySaver / SqliteSaver / PostgresSaver |
RAM (teste), fișier SQLite (local), PostgreSQL (producție). |
compile(store=...) |
Memorie pe termen lung, comună mai multor fire. |
Exemple practice și scenarii reale
Exemplul 1: Conversație continuată și stare inspectată
graph.invoke({"messages": [{"role": "user", "content": "Ce cod ți-am spus?"}]}, config)
stare = graph.get_state(config)
print(stare.values["messages"][-1].text)
print(stare.next)
Exemplul 2: Checkpointer PostgreSQL
from_conn_string se folosește ca context manager; setup() creează tabelele la prima rulare.
pip install langgraph-checkpoint-postgres
from langgraph.checkpoint.postgres import PostgresSaver
DB_URI = "postgresql://postgres:postgres@localhost:5432/postgres?sslmode=disable"
with PostgresSaver.from_conn_string(DB_URI) as checkpointer:
checkpointer.setup()
graph = builder.compile(checkpointer=checkpointer)
graph.invoke(intrare, {"configurable": {"thread_id": "client-7"}})
Greșeli frecvente și capcane
- Să apelezi graful fără
thread_id. Checkpointer-ul nu are unde să salveze starea; documentația îl cere la fiecare apel. InMemorySaverîn producție. Toate checkpoint-urile se pierd la repornirea procesului.thread_idfoarte lungi cuPostgresSaver. Documentația recomandă sub 255 de caractere, de exemplu un UUID; checkpoint-urile vechi se curăță periodic, altfel cresc fără limită.
Întrebări & Exemple practice:
LangGraph: InMemorySaver (MemorySaver) și checkpointereAi o întrebare despre LangGraph: InMemorySaver (MemorySaver) și checkpointere sau ai descoperit un truc, prompt sau fragment de cod util? Distribuie-l cu ceilalți membri ai comunității!
Fii primul care pune o întrebare sau distribuie un fragment de cod / prompt!
Nu au fost adăugate încă întrebări sau resurse pentru această pagină. Dacă ai testat un prompt sau ai un snippet util, adaugă-l mai jos pentru comunitate.