← AI GitHub

AI GitHub

LangGraph for stateful agent workflows

Represent an agent workflow as nodes, transitions and explicit state.

AI AgentsPublished 2 min read

Key Takeaways

  • LangGraph can checkpoint graph state and interrupt a run so an application can resume it or request a human decision.
  • Choose a state shape before adding nodes.
  • Build a read-only lookup node and a human approval step, then stop the run and resume it using its saved state.
  • Durable workflow state does not make side effects idempotent.

How it works

LangGraph can checkpoint graph state and interrupt a run so an application can resume it or request a human decision. Edges make loops and branch conditions visible in the workflow.

What you need

Choose a state shape before adding nodes. If the application uses persistence, keep a stable execution identifier that can recover the intended run.

What to try first

Build a read-only lookup node and a human approval step, then stop the run and resume it using its saved state. Repeat the resume to check the effect on external calls.

Save the checkpoint immediately before a tool call. Resume from that state and verify the tool runs exactly as often as your application expects.

Where to look for failures

Durable workflow state does not make side effects idempotent. Design tool calls so a retried or resumed node cannot accidentally repeat a consequential action.

Related Franklin pages

Build the same two-step workflow with one tool and one failure case. Inspect how state, errors and tool permissions cross the boundary between the steps.

Browse Franklin for concrete examples of tools and services exposed through MCP. Franklin’s MCP directory

Project documentation

Try it for your workflow

Explore the project’s documentation for setup and usage, or save this page to a collection for later.

Read the project documentation ↗