惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

J
Java Code Geeks
腾讯CDC
博客园 - 聂微东
爱范儿
爱范儿
罗磊的独立博客
P
Proofpoint News Feed
博客园 - Franky
博客园 - 三生石上(FineUI控件)
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
酷 壳 – CoolShell
酷 壳 – CoolShell
Jina AI
Jina AI
Blog — PlanetScale
Blog — PlanetScale
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
博客园 - 司徒正美
美团技术团队
MongoDB | Blog
MongoDB | Blog
WordPress大学
WordPress大学
A
About on SuperTechFans
I
InfoQ
博客园_首页
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
H
Help Net Security
Microsoft Azure Blog
Microsoft Azure Blog
G
Google Developers Blog

博客园_首页

Linux实操--组管理、权限管理和定时任务 Java + EasyExcel 实现单个接口导出多个Excel Mem0 源码解析系列(二):提示词工程的深度剖析 Openclaw TaskFlow究竟是什么?和普通Skill技能有什么区别 博文阅读密码验证 - 博客园 嘉立创开源:应该是全网MicroPython教程最多的开发板 Hermes Agent 集成实践:从协议到生产 2026年AI编程工具横评:Cursor、Codex、Claude Code、Zed、Windsurf Java程序员必看的RAG入门教程 2026 AI效率神器:Superpowers + Claude Code 保姆级教程 本地大模型部署全攻略:从 0 到 1 玩转 Ollama 【从0到1构建一个ClaudeAgent】内存管理-上下文压缩 .NET 高级开发 | 设计、实现一个事件总线框架 电子小白入门之NE555 3. WorkBuddy:隐藏玩法,一键召唤专家,让 AI 以"专家身份"给你干活 和AI一起搞事情#3:Claude Teammate 游戏开发翻车实录 【OpenClaw】通过 Nanobot 源码学习架构---(7)Memory C# .NET 周刊|2026年3月3期 我在 Debian 11 上把 K8s 单机搭起来了,过程没你想的那么顺(/opt 目录版) 深度学习进阶(七)Data-efficient Image Transformer CLI+Skill搭建浏览器AI自动化框架,告别一切重复枯燥任务 告别Token账单无底洞:OpenClaw本地部署,重塑企业数据主权的唯一解 FastAPI+Vue:文件分片上传+秒传+断点续传,这坑我帮你踩平了! SBTI 爆火后,我做了个程序员版的 CBTI。。已开源 + 附开发过程 多模态检索开始进入工程期:用 Sentence Transformers 搭建可落地的 Multimodal RAG 100多行代码实现一个最简单的Agent(用ReAct) Claude Code 通关手册(八):推荐 5 个 Hooks,代码质量提升 3 倍 老板:“有人截图了!”。安全部门:“收到,马上查暗水印!” - why技术 技术之外,皆是人间 C#/.NET/.NET Core技术前沿周刊 | 第 69 期(2026年4.01-4.12)
AI开发-python-LangGraph框架(3-30-LangGraph 「追加式消息...
万笑佛 · 2026-04-22 · via 博客园_首页

在基于 LangGraph 构建对话类应用(聊天机器人、智能助手)时,状态管理是核心痛点之一。传统的状态更新往往是「覆盖式」的,每次更新都会清空原有数据,这对于需要保留完整对话历史的场景完全不适用。

今天就给大家分享 LangGraph 中极具实用性的追加式状态管理模式,专门解决对话历史保留问题,无需手动拼接消息,让状态自动追加、流畅迭代。

对话系统的本质是多轮交互、历史留存,用户的每一次提问、AI 的每一次回复,都需要完整保留在状态中,不能丢失任何一条消息。

如果用普通状态管理,每次更新都会覆盖之前的消息,对话会直接「断片」;而追加式状态的核心价值就是:新数据不会覆盖旧数据,而是自动拼接在原有数据之后,完美适配聊天机器人、对话交互等场景。

这种模式的优势非常直观:

  1. 自动保留完整对话历史,无需手动维护消息列表
  2. 状态更新极简,节点只需返回新数据,无需处理历史拼接
  3. 状态流转清晰,符合对话系统的交互逻辑
  4. 扩展性强,多轮对话、长文本交互都能轻松支持

实现追加式状态的关键,是 LangGraph 结合 Python 类型注解的精准设计,核心依赖两个要素:Annotated 类型注解 + 运算符合并规则。

在定义状态结构时,我们不再使用普通的列表类型,而是通过 Annotated 为状态字段绑定追加行为。这是告诉 LangGraph:这个字段的更新方式不是覆盖,而是追加。

搭配 operator.add 运算符,让 LangGraph 知道如何处理新旧状态的合并 —— 对于列表类型,add 运算符等价于列表拼接,新消息会自动追加到原有消息列表的末尾,全程无需手动编写拼接逻辑。

这就是追加式状态的底层逻辑:通过注解声明行为,通过运算符定义规则,让框架自动完成状态追加

基于这个核心原理,我们可以搭建一套完整的对话状态管理体系,整体分为三部分:

对话状态包含两类字段,各司其职:

  • 消息历史字段:使用追加规则,自动保留所有用户与 AI 的消息,是对话的核心数据
  • 辅助状态字段:使用普通覆盖规则,用于存储当前对话主题、状态标识等临时数据,每次更新直接覆盖

这种设计既保证了历史不丢失,又让辅助状态灵活更新,兼顾实用性与简洁性。

LangGraph 的节点函数是状态更新的入口,在追加式模式下,节点的逻辑极度简化:

  • 每个节点只需要生成当前需要新增的一条 / 一组数据
  • 直接返回新数据即可,框架会自动将其追加到原有状态中
  • 无需读取历史消息、无需拼接列表,代码更简洁、可读性更强

比如用户输入节点只需要生成用户的新消息,AI 回复节点只需要生成 AI 的新回复,剩下的追加工作完全交给框架处理。

按照对话的自然流程构建图结构:起始节点 → 用户输入节点 → AI 回复节点 → 总结节点 → 结束节点。

每一步节点执行后,状态都会自动追加新消息,最终在总结节点可以拿到完整的对话历史,实现从交互到总结的全流程闭环。

对比传统的手动维护状态,LangGraph 追加式状态的优势无可替代:

  1. 极简代码:告别手动列表拼接、状态合并,减少冗余代码
  2. 自动管理:框架自动处理消息追加,开发者专注业务逻辑
  3. 稳定可靠:避免因手动合并导致的消息丢失、顺序错乱问题
  4. 场景适配:完美匹配聊天机器人、对话系统、多轮交互等核心场景
  5. 易于扩展:新增节点、新增交互步骤,无需修改状态合并逻辑

这种追加式状态管理模式,不仅仅适用于简单的天气查询机器人,几乎所有需要保留历史交互记录的场景都能使用:

  • 智能客服机器人
  • 多轮对话式助手
  • 长文本交互应用
  • 带记忆功能的 AI 应用

它是 LangGraph 状态管理中最实用、最常用的模式之一,掌握这种设计思路,能让你基于 LangGraph 开发对话类应用时,效率翻倍、稳定性拉满。

LangGraph 的追加式状态管理,通过 Annotated + 运算符的优雅设计,解决了对话系统中历史状态保留的核心难题。它把复杂的状态合并逻辑交给框架,让开发者专注于业务流程与节点逻辑,是构建高质量对话应用的必备技巧。

后续我会继续分享 LangGraph 状态管理的其他进阶模式,帮助大家彻底掌握 LangGraph 核心能力,轻松开发企业级 AI 应用。

实现代码:

"""
📌 模式2: 消息历史追加
核心机制: Annotated[List, add] 实现自动追加(非覆盖)
适用场景: 聊天机器人、对话系统、需要保留完整历史的场景
"""
import asyncio
from typing import TypedDict, List, Annotated
from operator import add  # 关键:列表追加操作符
from langgraph.graph import StateGraph, START, END
from langchain_core.messages import HumanMessage, AIMessage


# ===== 1. 状态定义(关键:Annotated + add)=====
class ChatState(TypedDict):
    """
    聊天状态设计:
    - messages: 使用 Annotated[List, add] → 自动追加新消息
    - current_topic: 当前对话主题(普通字段,覆盖更新)
    """
    messages: Annotated[List[HumanMessage | AIMessage], add]  # ⚠️ 核心:add 操作符
    current_topic: str


# ===== 2. 节点函数 =====
def user_input_node(state: ChatState) -> dict:
    """
    用户输入节点: 追加用户消息
    返回 {"messages": [新消息]} → 自动追加到历史
    """
    print(f"\n[用户输入] 当前消息数: {len(state['messages'])}")
    new_msg = HumanMessage(content="用户: 今天天气怎么样?")
    return {
        "messages": [new_msg],  # 返回单元素列表
        "current_topic": "天气查询"
    }


def ai_response_node(state: ChatState) -> dict:
    """
    AI回复节点: 追加AI消息
    ⚠️ 注意: 返回的 messages 会追加,不会覆盖历史!
    """
    print(f"[AI回复] 当前消息数: {len(state['messages'])}")
    new_msg = AIMessage(content="AI: 今天北京晴,25°C,适合外出")
    return {
        "messages": [new_msg],  # 再次返回单元素列表
        "current_topic": "天气详情"
    }


def summary_node(state: ChatState) -> dict:
    """
    总结节点: 展示完整对话历史
    """
    print(f"\n[对话总结] 总消息数: {len(state['messages'])}")
    for i, msg in enumerate(state['messages'], 1):
        role = "👤" if isinstance(msg, HumanMessage) else "🤖"
        print(f"  {role} 消息{i}: {msg.content[:30]}...")
    return {"current_topic": "对话结束"}


# ===== 3. 构建图 =====
def build_chat_graph():
    builder = StateGraph(ChatState)
    builder.add_node("user_input", user_input_node)
    builder.add_node("ai_response", ai_response_node)
    builder.add_node("summary", summary_node)

    builder.add_edge(START, "user_input")
    builder.add_edge("user_input", "ai_response")
    builder.add_edge("ai_response", "summary")
    builder.add_edge("summary", END)

    return builder.compile()


# ===== 4. 执行演示 =====
async def main():
    print("=" * 60)
    print("🧠 模式2: 消息历史追加(Annotated + add)")
    print("=" * 60)

    graph = build_chat_graph()
    # 画图
    print(graph.get_graph().draw_ascii())

    # 初始状态(必须初始化 messages 为空列表!)
    initial_state = {
        "messages": [],  # ⚠️ 关键:必须初始化,否则合并失败
        "current_topic": "初始"
    }

    print("\n【初始状态】messages 长度: 0")

    # 执行图
    final_state = await graph.ainvoke(initial_state)

    print("\n【最终状态】")
    print(f"  messages 长度: {len(final_state['messages'])}")
    print(f"  current_topic: {final_state['current_topic']}")




if __name__ == "__main__":
    asyncio.run(main())

结果输出:

============================================================
🧠 模式2: 消息历史追加(Annotated + add)
============================================================
 +-----------+   
 | __start__ |   
 +-----------+   
        *        
        *        
        *        
+------------+   
| user_input |   
+------------+   
        *        
        *        
        *        
+-------------+  
| ai_response |  
+-------------+  
        *        
        *        
        *        
  +---------+    
  | summary |    
  +---------+    
        *        
        *        
        *        
  +---------+    
  | __end__ |    
  +---------+

【初始状态】messages 长度: 0

[用户输入] 当前消息数: 0
[AI回复] 当前消息数: 1

[对话总结] 总消息数: 2
  👤 消息1: 用户: 今天天气怎么样?...
  🤖 消息2: AI: 今天北京晴,25°C,适合外出...

【最终状态】
  messages 长度: 2
  current_topic: 对话结束

更多学习资料尽在 老虎网盘资源