langchain-ai维护的LangGraph命令行工具langgraph-cli于上海时间2026年9月24日02时02分发布0.4.32正式版。GitHub发布页标称自cli==0.4.31起的增量,GitHub API标称published_at为2026-09-23T18:02:46Z,对应北京时间2026年9月24日02时02分;PyPI同版本轮子包上传时间为2026-09-23T18:02:34Z、源码包为2026-09-23T18:02:35Z,对应北京时间同日02时02分,均落在当日00:00至23:59窗口内。仓库地址为https://github.com/langchain-ai/langgraph,维护方为langchain-ai,版本为0.4.32,非预发布,对比基线为cli==0.4.31。许可证为MIT,发布说明未声明许可证变更。中国开发者可通过PyPI的langgraph-cli包升级验证,不改变LangGraph服务端与云服务的可用范围与计费规则。

关键变化

  • - 发布基线:release langgraph-cli==0.4.32,对比cli==0.4.31,非预发布,提交基线为7daa3ab - 自托管部署:feat place self-hosted deployments on a listener(#9056),支持将自托管部署置于监听器 - 代理标志与部署参数:feat clarify agent flags and support env defaults(#9063),澄清代理标志并支持环境变量默认值;feat update deploy to use agent_id and environment args(#9055),部署命令改用agent_id与环境参数;feat add --image-uri flag(#8482),新增自托管镜像地址参数 - 安全与依赖:fix remediate AnyIO vulnerabilities in example lockfiles(#9022),修复示例锁文件AnyIO漏洞;chore bump anyio 4.13.0至4.14.2(#8998),同步修复易受攻击的开发依赖(#8449),并升级httpx、httpcore、js-yaml等前后端依赖

适用对象与价值

面向已在本地或自托管环境使用LangGraph CLI创建、调试与部署智能体应用的开发者与团队,特别是需要将LangGraph应用以Docker方式发布到自有基础设施的场景。本次新增监听器 placement 与--image-uri参数,有助于按现有镜像治理流程复用已审核镜像;agent_id与环境参数调整有助于在多智能体与多环境之间明确部署目标;代理标志澄清与环境默认值支持有助于减少命令行与配置文件之间的歧义。对仅使用langgraph dev本地调试、未使用自托管部署的项目,影响较小,可按常规节奏评估升级。

兼容性与安装条件

本次为常规版本更新,发布说明未声明破坏性接口删除与许可证变更,对比区间为cli==0.4.31至cli==0.4.32的功能与依赖集合,可按常规小版本评估升级。但部署命令参数由原有方式改为agent_id与环境参数,已有脚本如硬编码旧参数需同步调整;代理标志语义澄清后,依赖旧默认行为的启动脚本需复核。PyPI元数据显示需要Python大于等于3.10,许可证表达式为MIT;运行依赖包括click、httpx、langgraph-sdk、pathspec与python-dotenv等,inmem额外依赖langgraph-api与langgraph-runtime-inmem。安装沿用PyPI体系,仓库为https://github.com/langchain-ai/langgraph,可执行pip install -U langgraph-cli==0.4.32或uv add langgraph-cli,需公网访问GitHub与PyPI,内网环境需提前同步轮子包langgraph_cli-0.4.32-py3-none-any.whl与源码包。实际部署可用性、区域与配额以自有基础设施与LangSmith侧配置为准。

限制与注意事项

发布说明仅列出上述功能与依赖项,未提供基准性能、成功率或成本对比数据,不应将其理解为性能提升承诺。自托管监听与镜像参数为CLI侧的部署封装能力,实际调度效果仍受目标集群、网络与镜像本身影响,服务端差异可能影响可用性。本次安全修复范围为示例锁文件AnyIO漏洞与开发依赖清理,未声明为覆盖全量运行时的安全公告,也不改变已知安全边界。许可证效果、长期维护与后续版本兼容不作超出发布说明的保证。升级前建议在预发环境验证langgraph new、dev、up、build与dockerfile流程,以及部署配置缺失提示与环境变量默认值行为回归。

下一步

已使用该CLI的项目可将版本固定至0.4.32,在预发环境验证自托管部署监听、agent_id与环境参数、--image-uri构建、代理标志默认值与缺失配置提示后发布。未接入的团队可按仓库libs/cli说明完成初始化与langgraph.json配置。更多细节见Release langgraph-cli==0.4.32说明、提交#9056、#9063、#9055、#8482与#9022,以及GitHub API中的published_at与PyPI中的upload_time对应北京时间2026年9月24日的归一验证。