当日发布与版本定位

langchain-ai/langgraph 的官方 Release 显示，sdk==0.4.4 于 2026-08-27T21:25:36Z（北京时间 2026-08-28 05:25:36）正式发布，落在本次运行的 Asia/Shanghai 当日 00:00–23:59 窗口内。GitHub API 标记该版本为正式发布（prerelease false），对应标签 sdk==0.4.4，维护提交为 release(sdk-py): 0.4.4 (#8738)。站内已有 open-source-project 条目中尚无 LangGraph canonical 页面（已核对 slug langgraph 未被占用），因此新建独立条目，不与 LangChain、llama.cpp 等项目重复。

关键变化

本次核心为可观测性改进：在线程流场景下，SDK 新增将 LangSmith 追踪从 thread streams 路由转发的能力。此前通过线程流消费的长运行智能体，其 LangSmith 链路可能无法完整归集，影响调试与复盘；新实现将线程流产生的追踪正确路由至 LangSmith，使执行路径、状态转换与运行时指标在可视化工具中完整呈现。相关特性由 feat: route LangSmith traces from thread streams (#8723) 引入，经合并后随 0.4.4 发布。

发布层面为例行维护更新，除该特性外仅含版本标识与合并提交，未调整核心编排 API、持久化、人机协同或内存模型，未引入破坏性变更。该 SDK 与 LangGraph 核心框架及 LangChain 生态保持兼容，适用于已部署 LangGraph Platform 的应用。

适用对象与价值

适合已在生产或预研中使用 LangGraph 构建长运行、有状态智能体，并接入 LangSmith 进行评估与可观测的中国团队。典型场景包括客服工单智能体、数据分析流水线、内容生成与审核代理等需要持久化、断点续跑与人工介入的系统。本次改进使线程流消费模式下的追踪不再缺失，便于回溯失败路径、度量时延与费用，并在多会话间保持一致的可见性。对未使用 LangSmith 或未采用线程流的项目，影响较小。

兼容性与安装条件

  • pip 安装：pip install -U langgraph-sdk==0.4.4 或 pip install -U langgraph（按需）；验证：python -c "import langgraph_sdk; print(langgraph_sdk.__version__)" 或检查 PyPI 页面；需 Python 3.10 及以上，支持 Linux、macOS、Windows，网络可访问 PyPI。
  • 仓库由 langchain-ai 维护，采用 MIT 许可，允许商业使用与分发，需保留版权与许可声明。SDK 本身不捆绑模型权重，模型与平台接入另行遵循提供方说明与费用策略。

限制与验证建议

本次为小幅维护更新，未变更许可证、未声明安全修复或 CVE，未改变部署拓扑。已知限制为该版本仅针对 Python SDK 的线程流追踪路由，其他语言或核心执行引擎的变更需关注对应 Release。生产升级前建议在预发环境对比开启与关闭 LangSmith 的线程流请求，检查追踪是否按线程正确归集、详情页无缺失、时延与 token 统计无异常，再全量推广。

若当前未使用线程流或 LangSmith，可暂缓升级；后续迭代将继续以 SDK 形式发布，关注官方 Release 列表与 PyPI 变更记录即可，已安装 0.4.3 的项目可按常规依赖更新流程替换。