1. 培歌行学LangGraph：从 LangChain 到 LangGraph 的思维跃迁
2. 培歌行学LangGraph：Reducer彻底搞懂
3. 培歌行学LangGraph：编译、执行与可视化
4. 培歌行学LangGraph：简单了解图的状态管理
5. 培歌行学LangGraph：状态管理与graph.invoke入参详细说明

在建立复杂的 LangGraph 应用时单一的状态 Schema 往往难以满足需求。再看常见痛点包括，

• 外部调用方能传入任意字段，导致数据不受控制。
• 内部实现细节暴露给调用方，造成接口臃肿。
• 节点间共享全局状态导致临时数据被污染，难以追踪。怎么说呢，
• 调试时无法精准定位是哪个节点写了哪块数据。

为解决上述痛点，LangGraph 引入了Multi Schema 多状态管理方法。它允许在同一个图中使用多个状态 Schema。每个 Schema 管理不同类型的数据，这样就能实现更清晰的数据流和更安全的接口定义。

一、四类状态概述

LangGraph 支持以下四类状态：

全局状态

   全局状态是创建 StateGraph 时通过 state_schema=... 参数传递的 Schema。它包含图运行过程中需要读写的大部分字段，是所有节点默认可以访问的数据。

// 定义全局状态
class OverAllState:
username: str
nickname: str
graph_output: str
// 创建 State Graph
builder = StateGraph

输入状态

输入状态通过 input_schema=... 参数定义，用于约束调用图时允许传入哪些字段。其实，它相当于图'对外接口'。外部调用方只能传入输入 状态中定义的字段，从而避免无效或恶意数据进入程序。

// 输入 state
class InputState:
username: str

// 在创建 graph 时指定 builder = StateGraph( OverAllState。input_schema=InputState,)

输出状态

输出 状态通过 output_schema=... 参数定义，用于约束图最终返回哪些字段。这让你能够确保即使内部产生了大量信息。也只公开必要的数据给调用方，从而提高安全性和可维护性。

// 输出 state
class OutputState:
graph_output: str

私有状態

私有状態并不通过 Graph 构造函数声明，而是通过节点函数参数类型注解 来定义。它用于在某些节点之间传递临时数据。不会出现在外部接口或结果中，从而避免泄漏内部实现细节。

// 私有 state 声明
class PrivateState:
greeting: str

// 节点函数签名示例 def node_2 -> PrivateState: return {"greeting": state + "。早上好~"}

二、 状态之间关系与设计规范

设计规范概览

• **规范一**：输入 状态 & 输出 状态通常是全局 状态 的子集，以避免额外冗余字段。
• **规范二**：私有 状态 与 全局 状态 的 字段名应尽量避免重复，以免误认为是共享变量。
• **规范三**：每个 节点 函数必须明确声明 入参 与 返回 类型，让静态检查工具能捕捉错误。
• **规范四**：节点只能访问 入参 类型中存在 的 字段，否则会抛出 KeyError 并导致整个流程中断。
• **规范五**：节点 返回 的 字典最好 与 返回 类型 注解 保持一致，提高代码 可读性 和 调试效率。

至于规范一，输入 & 输出 是全局子集

class OverAllState: username:str # 必须包含 Input 中字段 nickname:str # 可选，但推荐保持统一结构 graph_output:str# 必须包含 Output 中字段

规范二的观点是，私有 & 全局 不同名

#⚠️ 错误示例 ⚠️： 若 private_state 与 global_state 字段重名，将导致调试混乱，例如:

// 错误做法：
class PrivateState:
nickname:str # 与 Global 冲突

def node_5 -> PrivateState: return {"nickname":"你好"} // 难以判断是修改 global.nickname 还是 new private.nickname

规范三的观点是。明确声明 Node 输入/返回

// 正确写法：
def node_1 -> OverAllState:
return {"nickname": f"Dear {state}"}

规范四的观点是，禁止访问不存在字段

// 错误：
def node6 -> OverAllState:
return {"nickname": state} // KeyError

// 推荐做法：
def node_7 -> PrivateSt:
return {"greeting":"Hi"} // 与 PrivateSt 对齐