KI und LLMAgenten

LangGraph-Checkpoints

Persistieren Sie LangGraph-Agenten auf HotKV. Pausieren, fortsetzen und zeitreisen Sie durch den Graph-Zustand und halten Sie das Langzeitgedächtnis nach Bedeutung durchsuchbar.

Konformitätstests bestanden
81
Saver
Sync + async
nötig
Keine Lizenz
Schritt 1 von 6
Installieren

Ein Paket für Checkpointer und Store. Python 3.10 oder neuer.

Beispielsitzungplaying
# Installieren
$ pip install langgraph-checkpoint-hotkv
Successfully installed langgraph-checkpoint-hotkv

Ein animierter Durchlauf mit echten HotKV-Befehlen und Beispielantworten. Klicken Sie auf einen Schritt, um direkt dorthin zu springen. Befehle und Antworten bleiben auf Englisch, genau so, wie Sie sie in HotKV eingeben und sehen.

Das Problem

Ein LangGraph-Agent, der seinen Zustand im Prozessspeicher hält, verliert bei einem Neustart alles. Freigaben mit Human-in-the-Loop können nicht über Nacht warten, fehlgeschlagene Läufe lassen sich nicht fortsetzen, und nichts, was der Agent gelernt hat, überdauert bis zum nächsten Gespräch.

So löst HotKV es

langgraph-checkpoint-hotkv speichert die Checkpoints jedes Graphen in HotKV. Ein Graph lässt sich unterbrechen und fortsetzen oder zu jedem früheren Schritt zurückspulen und von dort verzweigen. Der zugehörige Store hält das Langzeitgedächtnis threadübergreifend vor, auffindbar nach Namespace, nach Filter oder, mit einem Embedding-Modell, nach Bedeutung.

Schritt für Schritt

Was passiert, Befehl für Befehl

  1. 01

    Installieren

    Ein Paket für Checkpointer und Store. Python 3.10 oder neuer.

    pip install langgraph-checkpoint-hotkv
  2. 02

    Mit einem HotKV-Checkpointer kompilieren

    Jeder Schritt des Graphen wird jetzt in HotKV gespeichert.

    graph = builder.compile(checkpointer=HotKVSaver(hotkv.from_url("hotkv://localhost:6379")), interrupt_before=["refund"])
  3. 03

    Laufen bis zur Freigabe

    Der Graph arbeitet seine Schritte ab, speichert nach jedem einen Checkpoint und hält vor der Erstattung an.

    graph.invoke({"messages": [("user", "Refund order 1182")]}, {"configurable": {"thread_id": "t-81"}})
  4. 04

    Stunden später, nach einem Neustart

    Der Prozess wurde über Nacht neu gestartet. Der Zustand liegt weiter in HotKV und wartet am selben Schritt.

    graph.get_state({"configurable": {"thread_id": "t-81"}}).next
  5. 05

    Freigeben und fortsetzen

    Der Freigeber sagt Ja, und der Graph macht ab dem gespeicherten Checkpoint weiter.

    graph.invoke(None, {"configurable": {"thread_id": "t-81"}})
  6. 06

    Threadübergreifend erinnern

    Das Langzeitgedächtnis liegt im Store und wird in jedem späteren Gespräch wiedergefunden.

    store.put(("users", "42"), "prefs", {"refunds": "prefers store credit"})
Wo es passt

Szenarien aus der Praxis

Workflows mit Human-in-the-Loop

Erstattungen, Vertragsänderungen und Produktions-Deployments warten Minuten oder Tage auf die Freigabe durch eine Person, ohne einen Prozess offen zu halten.

Lang laufende Recherche-Agenten

Ein Lauf, der bei Schritt 40 fehlschlägt, macht bei Schritt 40 weiter, statt von vorn zu beginnen.

Debugging und Evaluierung

Gehen Sie zu einem früheren Checkpoint zurück, ändern Sie die Eingabe und verzweigen Sie, um zu sehen, wie sich der Agent verhalten hätte.

Integriert

Was Sie bekommen

Checkpointer

HotKVSaver und AsyncHotKVSaver halten den Graph-Zustand zwischen Läufen vor, mit Unterbrechen, Fortsetzen und Zeitreise.

Langzeit-Store

HotKVStore hält Einträge threadübergreifend vor, durchsuchbar nach Namespace, Filter oder Bedeutung, mit optionalem Ablauf.

Auf Konformität getestet

Besteht die eigene Checkpointer-Konformitätssuite von LangGraph, 81 Tests in 8 Fähigkeiten, für beide Saver.

Keine Module, keine Lizenz

Nutzt die Kerndatentypen und den Vektorindex von HotKV und funktioniert mit oder ohne Enterprise-Lizenz.

Checkpointer und Store

python
from langgraph.checkpoint.hotkv import HotKVSaver

with HotKVSaver.from_conn_string("hotkv://localhost:6379") as checkpointer:
    graph = builder.compile(checkpointer=checkpointer)
    graph.invoke({"messages": [("user", "hi")]}, {"configurable": {"thread_id": "1"}})

Häufige Fragen

Brauche ich eine Enterprise-Lizenz?

Nein. Checkpointer und Store nutzen die Kerndatentypen und den Vektorindex von HotKV und funktionieren auf einem Server mit oder ohne Lizenz.

Wird async unterstützt?

Ja. AsyncHotKVSaver und AsyncHotKVStore funktionieren mit ainvoke und astream.

Können sich mehrere Apps einen Server teilen?

Ja. Alles wird unter einem Key-Präfix gespeichert, standardmäßig langgraph, das Sie pro Anwendung oder Umgebung ändern können.

Verwandte Anwendungsfälle

Probieren Sie es mit Ihrer eigenen Workload

HotKV spricht das Redis-Protokoll, sodass Sie einen bestehenden Client darauf richten und genau diese Befehle ausführen können.