Do Not Treat LangGraph As A Longer Chain

Hören Sie auf, LangGraph als LangChain mit mehr Schritten zu betrachten. Dieser Fehler führt zu fehlerhaften Agenten.

LangGraph ist für Workflows gedacht, die State, Verzweigungen, Tool-Aufrufe und menschliche Freigaben erfordern. Es ist für Agenten konzipiert, die sich von Fehlern erholen müssen, ohne neu zu starten.

Wenn Sie es verwenden, müssen Sie zuerst drei Dinge definieren: State, Interrupts und Recovery.

The First Boundary: State Schema

Bei einem einzelnen Prompt ist die Grenze der Text. Bei LangGraph ist die Grenze das State-Schema. Sie müssen entscheiden:

  • Welche Felder zwischen den Nodes übertragen werden.
  • Welche Felder ein Node aktualisiert.
  • Wie parallele Zweige Werte zusammenführen.
  • Welche Werte in einen Checkpoint einfließen.
  • Welche Werte niemals persistiert werden dürfen.

Reducers sind hier entscheidend. Wenn Sie keine ordnungsgemäße Regel zum Anhängen (Append) von Nachrichten festlegen, werden bei Ihren parallelen Prozessen Daten verloren gehen.

Fangen Sie klein an. Bauen Sie einen Graphen mit einem Schema, einem Node und einem Reducer. Wenn Sie das nicht zum Laufen bringen, wird das Hinzufügen von Tools Ihre Fehler nur kaschieren.

The Runtime Boundary

Bevor Sie compile() aufrufen, ist Ihr Graph nur eine Beschreibung. Nach compile() übernimmt die Runtime.

Wenn ein Graph fehlschlägt, schauen Sie nicht nur auf den Node. Überprüfen Sie diese vier Dinge:

  • Erlaubt das State-Schema dem Node, diesen Key zu schreiben?
  • Gibt der Node ein gültiges State-Feld zurück?
  • Führt der Reducer die Daten korrekt zusammen?
  • Hat der Conditional Edge einen Ausstiegspfad?

The Human In The Loop

Betrachten Sie die menschliche Freigabe nicht als UI-Feature. Betrachten Sie sie als einen Graph-Vertrag.

Ein zuverlässiges Muster sieht so aus:

  • Das Modell schlägt einen Tool-Aufruf vor.
  • Der Graph löst einen Interrupt aus.
  • Ein Mensch genehmigt oder bearbeitet die Aktion.
  • Der Graph setzt genau an diesem Punkt fort.

Dies macht Agenten wiederherstellbar (recoverable) statt nur reaktiv.

Your Smoke Checklist

Bevor Sie in die Produktion gehen, führen Sie diesen Test durch:

  • Verwenden Sie ein temporäres Verzeichnis ohne Produktionsdaten.
  • Definieren Sie einen minimalen State.
  • Schreiben Sie einen Node, der nur gültige Felder zurückgibt.
  • Verwenden Sie einen Reducer für Append-Aktionen.
  • Fügen Sie einen Interrupt vor einer Tool-Aktion hinzu.
  • Fügen Sie einen Checkpointer hinzu.
  • Erzwingen Sie einen Fehler und überprüfen Sie das Verhalten bei der Fortsetzung (Resume-Behavior).

Wenn dieser Pfad fehlschlägt, fügen Sie keine weiteren Tools hinzu. Das Problem liegt an Ihrer Runtime-Grenze.

LangGraph ist nicht für einmalige Modellaufrufe gedacht. Nutzen Sie es, wenn Ihre KI mehrstufige Aufgaben erledigen muss, die inspizierbar, pausierbar und überprüfbar sind.

Source: https://dev.to/doramagic/do-not-treat-langgraph-as-a-longer-chain-define-state-interrupts-and-recovery-first-4n3n

Optional learning community: https://t.me/GyaanSetuAi