Persistir el estado del grafo (puntos de control)

¿Por qué persistir el estado?

Checkpointer en memoria

from langgraph.checkpoint.memory import MemorySaver

checkpointer = MemorySaver()
app = graph.compile(checkpointer=checkpointer)

Checkpointer de Postgres

from langgraph.checkpoint.postgres import PostgresSaver

checkpointer = PostgresSaver.from_conn_string('postgresql://...')
await checkpointer.setup()   # create tables
app = graph.compile(checkpointer=checkpointer)

Checkpointer de Sqlite

from langgraph.checkpoint.sqlite import SqliteSaver
import sqlite3

conn = sqlite3.connect('agents.db', check_same_thread=False)
checkpointer = SqliteSaver(conn)

IDs de hilo

config = {'configurable': {'thread_id': 'user-42-conversation-1'}}
result = app.invoke({'messages': [...]}, config)

Reanudar una ejecución

# Some hours later:
app.invoke(None, config)

Inspección del estado

snapshot = app.get_state(config)
print(snapshot.values)         # current state dict
print(snapshot.next)           # which node is next
print(snapshot.created_at)

Historial del estado

for snapshot in app.get_state_history(config):
    print(snapshot.created_at, snapshot.values)

Bifurcar una ejecución

app.update_state(config, {'plan': 'a different plan'})
app.invoke(None, config)   # continue with the new plan

Intervención humana con interrupt_before

app = graph.compile(
    checkpointer=checkpointer,
    interrupt_before=['send_email']
)

result = app.invoke({'messages': [...]}, config)
# Agent paused. Human inspects state.
# When approved:
app.invoke(None, config)

Reanudar después de editar

app.update_state(config, {'email_draft': 'final version'})
app.invoke(None, config)

Seguimiento de costes entre checkpoints

class State(TypedDict):
    cost_usd: Annotated[float, lambda a, b: a + b]

# Every LLM-calling node adds to it.

Limpieza

await checkpointer.delete(thread_id='old-thread')

Reanudar hilos

Repaso