docs: x-refs and explainer in tool node docs (#6653)

This commit is contained in:
Mason Daugherty
2026-01-05 20:17:38 +00:00
committed by GitHub
parent 3a9749a0ed
commit 8ccead9560
+13 -5
View File
@@ -15,12 +15,12 @@ The module implements design patterns for:
Key Components:
- `ToolNode`: Main class for executing tools in LangGraph workflows
- `InjectedState`: Annotation for injecting graph state into tools
- `InjectedStore`: Annotation for injecting persistent store into tools
- `ToolRuntime`: Runtime information for tools, bundling together `state`, `context`,
- [`ToolNode`][langgraph.prebuilt.ToolNode]: Main class for executing tools in LangGraph workflows
- [`InjectedState`][langgraph.prebuilt.InjectedState]: Annotation for injecting graph state into tools
- [`InjectedStore`][langgraph.prebuilt.InjectedStore]: Annotation for injecting persistent store into tools
- [`ToolRuntime`][langgraph.prebuilt.ToolRuntime]: Runtime information for tools, bundling together `state`, `context`,
`config`, `stream_writer`, `tool_call_id`, and `store`
- `tools_condition`: Utility function for conditional routing based on tool calls
- [`tools_condition`][langgraph.prebuilt.tools_condition]: Utility function for conditional routing based on tool calls
Typical Usage:
```python
@@ -614,6 +614,14 @@ class ToolNode(RunnableCallable):
persistent storage, and control flow. Manages parallel execution,
error handling.
Use `ToolNode` when building custom workflows that require fine-grained control over
tool execution—for example, custom routing logic, specialized error handling, or
non-standard agent architectures.
For standard ReAct-style agents, use [`create_agent`][langchain.agents.create_agent]
instead. It uses `ToolNode` internally with sensible defaults for the agent loop,
conditional routing, and error handling.
Input Formats:
1. **Graph state** with `messages` key that has a list of messages:
- Common representation for agentic workflows