langgraph的四种state解析
下面我们来深入拆解这段 LangGraph 代码中出现的 四种 State状态形式并结合执行流程说明它们各自的作用、约束与数据流转方式。1. 四种 State 的定义与角色① InputState输入状态pythonclassInputState(TypedDict):user_input:str角色定义外部调用者向图Graph发起请求时必须传入的数据结构。使用位置在创建 StateGraph时通过 input_schemaInputState指定。特点仅描述“入口数据”不包含图内部产生的中间或最终结果。调用 graph.invoke({“user_input”: “My”})时参数必须兼容 InputState。与本例关系初始全局状态中只有 user_input: “My”。② OutputState输出状态pythonclassOutputState(TypedDict):graph_output:str角色定义图执行完毕后返回给外部的结果结构。使用位置在创建 StateGraph时通过 output_schemaOutputState指定。特点对全局状态进行“裁剪”最终只保留此处声明的字段。示例中返回 {‘graph_output’: ‘My name is Lance’}。与本例关系即使全局状态还包含 foo、bar、user_input输出时也被过滤得只剩 graph_output。③ OverallState总体状态pythonclassOverallState(TypedDict):foo:struser_input:strgraph_output:str角色定义整个图内部维护的完整全局状态即“总状态”。使用位置作为 StateGraph的第一个类型参数StateGraph(OverallState, …)。特点理论上应囊括所有节点需要读写的状态字段本例为了演示故意没放 bar。各节点函数的输入/输出可以只是它的子集LangGraph 负责合并。初始时由 InputState注入user_input随后被各个节点逐步填充。与本例关系初始{“user_input”: “My”}foo、graph_output暂缺node_1 写入 foo→ {“user_input”: “My”, “foo”: “My name”}node_3 写入 graph_output→ 最终全局状态含三个键外加临时的 bar④ PrivateState私有/局部状态pythonclassPrivateState(TypedDict):bar:str角色定义某两个或多个相邻节点之间传递的临时数据结构不属于全局状态的正式 schema。使用位置仅作为某些节点的输入输出类型标注非图级配置。特点用于封装中间计算结果避免污染 OverallState。LangGraph 允许节点返回未在 OverallState中声明的字段并传递给下一节点只要下一节点标注接收该结构。最终不会被 OutputState输出。与本例关系node_2返回 {“bar”: “My name is”}写入私有状态node_3接收 PrivateState读取 bar并生成最终输出。2. 数据流转全过程结合代码python graph.invoke({user_input:My})步骤节点接收的状态类型标注实际可访问的字段返回的状态全局状态变化START→node_1node_1InputStateuser_input“My”{“foo”: “My name”} foonode_1→node_2node_2OverallStateuser_input, foo{“bar”: “My name is”} bar(私有)node_2→node_3node_3PrivateStatebar{“graph_output”: “My name is Lance”} graph_outputnode_3→END输出OutputState——仅保留 graph_output最终输出python{graph_output:My name is Lance}3. 核心设计思想总结关注点分离InputState对外契约调用方知道传什么OutputState对外契约调用方知道收什么OverallState对内全景图作者管理全量状态PrivateState节点间临时契约解耦中间逻辑类型驱动LangGraph 利用 Python 类型标注TypedDict在编译期/运行期做状态校验与自动补全提示。渐进式状态构建全局状态从输入开始经各节点返回的部分状态不断合并最后按输出 schema 剪裁。代码此代码取自官方给的demofromtypingimportTypedDictfromlanggraph.graphimportEND,START,StateGraphclassInputState(TypedDict):user_input:strclassOutputState(TypedDict):graph_output:strclassOverallState(TypedDict):foo:struser_input:strgraph_output:strclassPrivateState(TypedDict):bar:strdefnode_1(state:InputState)-OverallState:# Write to OverallStatereturn{foo:state[user_input] name}defnode_2(state:OverallState)-PrivateState:# Read from OverallState, write to PrivateStatereturn{bar:state[foo] is}defnode_3(state:PrivateState)-OutputState:# Read from PrivateState, write to OutputStatereturn{graph_output:state[bar] Lance}builderStateGraph(OverallState,input_schemaInputState,output_schemaOutputState)builder.add_node(node_1,node_1)builder.add_node(node_2,node_2)builder.add_node(node_3,node_3)builder.add_edge(START,node_1)builder.add_edge(node_1,node_2)builder.add_edge(node_2,node_3)builder.add_edge(node_3,END)graphbuilder.compile()graph.invoke({user_input:My})# {graph_output: My name is Lance} 实践中为了避免混淆通常建议把所有会被多个节点使用的字段都放进OverallState而将PrivateState视为可选的精细化工具。本例特意将bar放在PrivateState是为了演示四种形态的共存与区别。

相关新闻

Claude Code Desktop安装与配置全指南

Claude Code Desktop安装与配置全指南

1. Claude Code Desktop概述与核心价值 Claude Code Desktop是Anthropic公司推出的智能编程辅助工具,专为开发者设计的多功能集成环境。不同于普通的代码编辑器,它深度融合了AI编程助手Claude的核心能力,通过图形化界面提供智能代码补全、实时…

2026/11/14 13:15:55 阅读更多 →
分布式模型预测控制在多智能体点对点转移中的应用

分布式模型预测控制在多智能体点对点转移中的应用

1. 多智能体点对点转移控制概述多智能体系统的点对点转移控制是指多个自主智能体从初始位置出发,通过协同控制策略到达各自指定目标位置的过程。这类问题在无人机编队、仓储机器人、自动驾驶车队等场景中具有广泛应用价值。传统集中式控制方法在面对大规模系统时存在…

2026/11/21 14:18:11 阅读更多 →
Windows XP进程管理技巧与安全防护实战

Windows XP进程管理技巧与安全防护实战

1. Windows XP进程管理深度解析Windows XP作为一代经典操作系统,其进程管理机制至今仍被许多老旧设备和特定场景所使用。与现代操作系统相比,XP的进程管理界面确实显得简陋——任务管理器默认不显示进程路径就是典型例子。但通过系统内置工具&#xff0c…

2026/11/20 12:40:44 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/21 23:27:35 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/21 23:27:35 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/21 23:27:35 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/21 23:27:35 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/21 23:27:36 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/21 23:27:37 阅读更多 →

日新闻

周新闻

月新闻