Skip to content

docs(langgraph): document StateGraph.set_node_defaults() on fault-tolerance#3974

Draft
open-swe[bot] wants to merge 4 commits into
mainfrom
open-swe/fault-tolerance-set-node-defaults
Draft

docs(langgraph): document StateGraph.set_node_defaults() on fault-tolerance#3974
open-swe[bot] wants to merge 4 commits into
mainfrom
open-swe/fault-tolerance-set-node-defaults

Conversation

@open-swe
Copy link
Copy Markdown
Contributor

@open-swe open-swe Bot commented May 12, 2026

Description

Documents the new fluent StateGraph.set_node_defaults() builder method shipped in langchain-ai/langgraph#7747. Adds a new Graph-wide defaults section to the fault-tolerance page covering supported kwargs (retry_policy, timeout, cache_policy, error_handler), the override precedence rule, and which defaults apply to error-handler nodes. Also registers set_node_defaults in the API link map.

Release Note

Document StateGraph.set_node_defaults() for configuring graph-wide retry, timeout, cache, and error-handler defaults.

Test Plan

  • Verify the new Graph-wide defaults section renders correctly on the LangGraph fault-tolerance page and that the @[\set_node_defaults`]` link resolves to the published API reference once the langgraph release containing #7747 is live.

Opened collaboratively by Quanzheng Long and open-swe.

…erance page

Adds a 'Graph-wide defaults' section covering the new fluent
StateGraph.set_node_defaults() builder method from
langchain-ai/langgraph#7747, including the supported kwargs and the
rules for which defaults apply to error-handler nodes. Also registers
'set_node_defaults' in the API link map so @[`set_node_defaults`]
resolves.

Co-authored-by: Quanzheng Long <4523955+longquanzheng@users.noreply.github.com>
@github-actions github-actions Bot added docs-infra langgraph For docs changes to LangGraph oss python For content related to the Python version of LangChain projects internal labels May 12, 2026
Open SWE (open-swe) and others added 3 commits May 12, 2026 18:38
…antics

Adds two pointers to the Error handling section's 'Resume-safe failures'
subsection:

- The handler transition is atomic at the superstep boundary: the
  original node's error write is committed and the handler is scheduled
  in the same step. The failing node is never re-executed once the
  error-handling phase has begun.
- Handler crashes resume safely: if the handler itself raises and a
  checkpointer is configured, resuming re-schedules the handler, not
  the original failing node.

Co-authored-by: Quanzheng Long <4523955+longquanzheng@users.noreply.github.com>
Broaden the handler-resume pointer to cover host process crashes mid-handler,
not just handler-raised exceptions.

Co-authored-by: Quanzheng Long <4523955+longquanzheng@users.noreply.github.com>
@github-actions
Copy link
Copy Markdown
Contributor

Mintlify preview branch generated: preview-opensw-1778611447-4ebee5c

Site preview: https://langchain-5e9cc07a-preview-opensw-1778611447-4ebee5c.mintlify.app

Preview links may take a few minutes to start working while the deployment finishes.

Changed documentation pages (preview deep links):

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-infra internal langgraph For docs changes to LangGraph oss python For content related to the Python version of LangChain projects

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants