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

推荐订阅源

cs.CL updates on arXiv.org
cs.CL updates on arXiv.org
B
Blog RSS Feed
宝玉的分享
宝玉的分享
腾讯CDC
博客园_首页
T
Tailwind CSS Blog
月光博客
月光博客
博客园 - 司徒正美
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
M
MIT News - Artificial intelligence
A
About on SuperTechFans
云风的 BLOG
云风的 BLOG
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
有赞技术团队
有赞技术团队
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
大猫的无限游戏
大猫的无限游戏
MongoDB | Blog
MongoDB | Blog
博客园 - 聂微东
V
Visual Studio Blog
H
Hackread – Cybersecurity News, Data Breaches, AI and More
SecWiki News
SecWiki News
美团技术团队
P
Privacy International News Feed
H
Help Net Security
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
Microsoft Security Blog
Microsoft Security Blog
Know Your Adversary
Know Your Adversary
Y
Y Combinator Blog
D
DataBreaches.Net
Project Zero
Project Zero
T
The Blog of Author Tim Ferriss
Cyberwarzone
Cyberwarzone
C
Cybersecurity and Infrastructure Security Agency CISA
C
Cisco Blogs
S
Schneier on Security
G
GRAHAM CLULEY
博客园 - 三生石上(FineUI控件)
Cisco Talos Blog
Cisco Talos Blog
小众软件
小众软件
Forbes - Security
Forbes - Security
D
Docker
T
Tenable Blog
S
Secure Thoughts
雷峰网
雷峰网
S
Security @ Cisco Blogs
T
The Exploit Database - CXSecurity.com
The Cloudflare Blog
博客园 - 【当耐特】
Spread Privacy
Spread Privacy
阮一峰的网络日志
阮一峰的网络日志

博客园_首页

Plist 二进制格式 Milvus 和 PGVector,哪个更好? OpenClaw 已过时?在 VS Code 中运行 Hermes Agent! 第30篇文章:一个大三计科生的自白 Manim如何在数学公式中完美显示中文? Docker 部署 RocketMQ 5 并发编程核心概念辨析 C#事务处理最佳实践:别再让“主表存了、明细丢了”的破事发生 CLI 是什么?为什么大厂突然集体卷命令行? 【从0到1构建一个ClaudeAgent】协作-自主Agent UIImageView 设置图片不生效的原因排查 最小二乘问题详解20:无先验约束下的增量式SFM自由网平差 痞子衡嵌入式:大话双核i.MXRT1180之XIP应用里借助MU实现可靠Flash IAP的方法 AI Chat 封装, SemanticKerne.AiProvider.Unified 已发布 Windows下右键编辑js文件无法打开记事本——在注册表中使用环境变量 在后台服务中使用 Scoped 服务,为什么总是报错? H200 安装驱动并使用sglang启动模型 wireshark 抓包Trap上报告警内容 我用 AI 辅助开发了一系列小工具(2):图片压缩工具 [A Primer On MC and CC] 2.1 Memory Consistency 1 - 指令重排序和 SC 模型 Oracle数据库SCN推进技术详解与实践指南 玩转控件:封装个带图片的Label控件 Claude Code 4.7 真正该升级的不是模型,而是你的工作流 前端小白一句话,AI 帮我做了个颜值拉满的桌面媒体播放器。当代码不再是门槛,一句话编程就是现实。 5. WorkBuddy: 小龙虾的灵魂三件套,让你的小龙虾不只是工具 SQLite 分片方案实战:三种分片策略的深度对比 告别简陋 UI!一款基于 Fluent Design 和基于 WinUI 的开源免费、现代化的 Avalonia UI 控件库 关于二进制排列组合枚举的总结 AI开发-python-LangGraph框架(3-27-LangGraph从零实现大模型智能决策工作流) ElasticSearch主分片和副本分片概念详解 【002】HTTPS 粗解:证书、TLS 握手与对后端配置的影响 Hermes Agent 一周暴涨五万 Star,但我劝你别急着追 明明连接的是Redis的DB0,为什么能查到DB3的数据? 【从0到1构建一个ClaudeAgent】协作-Agent团队 熟悉电子元器件之后,电子小白下一步该怎么走? MAF快速入门(23)通过C#类定义Skills .NET 高级开发 | 手写一个对象映射框架 FastAPI数据库ORM怎么选?我肝了三个Demo后,终于不再纠结了 mysqldump 参数拾遗:在遗忘与铭记之间 C# .NET 周刊|2026年3月5期 Claude code入门 - 陈彦斌 一文学习入门 ThingsBoard 开源物联网平台 GitHub 热门项目 | 2026年04月16日 如何为GIT设置全局勾子,为每次提交追加信息 Number.isFinite和isFinite与isNaN()和Number.isNaN的区别 PortSwigger SQL注入LAB2 推荐一个测试人必备的Skills,从功能到性能全搞定(附详细实操和安装下载方式) 筑基期:掌握Odoo基础核心知识点02(Odoo XML 开发方式详解) GLM模型这么火,咱们用vllm也咧一个呗! 深入理解 AbortController:从底层原理到跨语言设计哲学 字符串学习笔记 多租户系统框架的基础模块设计和分析设计 Apache SeaTunnel Zeta 为什么能做到“又快又稳”? AI开发-python-LangGraph框架(3-26-LangGraph基本概念及第一个简单样例) Vue 3 组件通信,别只会用 Props 和 Emits 了,这几个狠活儿你得看看 ElasticSearch7.X版本配置密码 用Manim实现动态交点计算--从一个动点问题说起 团结引擎+Addressable+Instant Game打包抖音小游戏 function call 实战:让 LLM 自动判断 pod 异常、调用日志工具并完成故障分析 bubseek —— 让 Agent 的足迹,变成团队的洞察 通过 C# 读取并导出 PDF 书签 如何用 GitHub Actions 实现 Steam 自动化发布 【从0到1构建一个ClaudeAgent】并发-后台任务 .NET 高级开发 | 定制 ASP.NET Core 框架 电子小白:什么是运算放大器(运放) zero2Agent:面向大厂面试的 Agent 工程教程,从概念到生产的完整学习路线 堆上的ORW HC32F460 USB CDC通信异常:非对齐访问异常排查 20260413-Hyperbridge 攻击事件:发生在默克尔山上的验证绕过 那些喊着AI 要淘汰你的人,正在靠你的焦虑赚大钱! 深度学习进阶(八)Swin Transformer 最小二乘问题详解19:带先验约束的增量式SFM优化与实现 SnapTranslate 3.0 正式发布:全局划词翻译 + 完整英语学习闭环,一站式搞定查词、记词、复习 工作的意义、工作的困难认知再思考 .NET + AI 进阶实战:基于类的技能开发 - 打造可治理的 Agent 能力模块 【从0到1构建一个ClaudeAgent】规划与协调-技能 上周热点回顾(4.6-4.12) 电子小白的工具三件套:面包板、杜邦线、万能板 单表五亿数据的查询优化 | Mysql、StarRocks 2. WorkBuddy:从“我是谁”到“帮我干活” C# 如何减少代码运行时间:7 个实战技巧 基于HelixToolkit.SharpDX 渲染3D模型 - 笺上知微 从零开始的双臂具身VLA起源及现阶段发展综述 - SkyXZ 记对 xonsh shell 的使用, 脚本编写, 迁移及调优 - pluvium27 受够了Vibe Coding的失控?换个起点,让AI事半功倍 从开始配置漏洞环境到漏洞复现流程 - 難しい 关于10年工作经验的程序员对OpenClaw的实战经验分享以及看法 - 虚无境 Any metadata 的内存布局 C# .NET 周刊|2026年3月2期 - InCerry 我帮你测过了,测试圈排名第二的 Skill 依然很牛逼 Skill Discovery | 无监督技能发现的经典工作总结 - MoonOut 上下文工程是什么?过时了么?一文讲明白! - 一枫说码 开了 TUN 模式还是直连?90% 的人都踩过这个坑 AScript扩展多种脚本语言 - rockey627 AI 学习笔记:Agent 的记忆机制 你能被装进一个文件里吗?——7 万人把同事"蒸馏"成了 AI - 我没有三颗心脏 Claude Code 通关手册(七):给 AI 装上技能包——Skills 完全指南 - 暮色之狐 在浏览器中快速编辑代码:VSCode Web 集成实践 - Newbe36524 蒸馏自己 skill?基于 Deepseek 的蒸馏器,丐版蒸馏方式,简单便捷 - To_Carpe_Diem Spring AI Aliababa和AgentScope,哪个更好? - 苏三说技术
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: 对话结束

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