LangGraph
0.2.28 (commit f05b546)基于有向有环图（Cyclical Graph）与持久化状态机的高可靠多主体智能体开发库。
本项独立技术评估严格针对 LangGraph 0.2.28 (commit f05b546) 版本的默认架构机制与工程特征观察，不代表对任何后续上游版本或您具体业务系统的安全背书或生产放行批准。Agent 在生产环境中的实际安全边界，严格取决于您的外置工具沙箱、网络出站白名单与两阶段审批流设计。
评审协议 v1.1；应在 2026年12月30日 前复核。披露状态：不适用——本档案记录公开架构观察，未开启私下漏洞披露。
证据等级：A = 可复现观察；B = 版本关联文档或源码；C = 证据不足或超出评审范围。
部署证据与观察范围概要
提供图状态机、可配置检查点、中断与递归限制；但工具沙箱、输入校验和外部副作用恢复仍属于应用责任。
五维工程控制边界与依赖说明
工具执行环境由开发者自行定义；框架原生提供了极佳的状态隔离边界。
强制配置全局递归步数上限（recursion_limit），状态转移路径必须显式声明。
强类型状态 Schema 可结构化节点间数据，但不会自动使 Prompt 内容可信，也不隔离工具执行。防注入能力取决于应用校验和工具边界。
配置检查点后可查看历史并重放状态，但不会自动撤销已发生的外部工具副作用；恢复仍需幂等工具或补偿逻辑。
LangSmith 在已复核版本中属于可选集成；固定源码不能证明每个节点都原生传播 OpenTelemetry 轨迹。
企业部署建议补齐的硬控制
- 生产环境必须启用持久化检查点存储（如 PostgreSQL Checkpointer）
- 在所有触发外部写操作的节点前配置 `interrupt_before` 中断断点，等待人工确认
- 对全局 State 及所有工具参数强制实施严格的 Pydantic 强类型校验
概述
LangGraph（由 LangChain 团队研发）是将 Agent 工作流建模为有环图的运行时库。它提供可配置检查点、中断和递归限制，但工具安全、持久存储与外部副作用撤销仍是应用责任。
审查范围与版本基线
- 官方仓库：langchain-ai/langgraph（MIT 许可证）。
- 评审版本：
0.2.28(Commitf05b546)。 - 目标执行模式：显式配置检查点、工具由应用定义的 Python 图运行时。
- 主要证据来源：固定标签的运行时源码、检查点参考 和 README。
- 非测试范围：LangGraph Platform/Cloud、后续 1.x 行为、应用自定义工具与运行时安全测试。
生产架构与控制边界分析
当应用配置检查点时，LangGraph 可持久化图状态，支持历史检查、重放以及通过 interrupt_before 和 interrupt_after 实现人机协同暂停。这些属于可选配置，而图状态重放不会撤销工具已完成的数据库写入、网络调用或其他外部副作用。
由于工具执行由应用代码定义，团队可以将工具放入隔离运行时，但 LangGraph 0.2.28 本身不提供这一沙箱边界。
部署证据与观察范围概要
LangGraph 0.2.28 提供显式图转移、递归限制、可选中断与可配置检查点。生产使用仍需隔离工具运行时、校验工具输入、在需要恢复时配置持久存储，并为外部副作用设计显式补偿。
说明：本证据档案反映对 LangGraph 0.2.28 的源码级架构观察，不能证明后续 1.x 行为、原生 OpenTelemetry 全链路覆盖、外部副作用自动回滚或生产放行。
准备在企业内部定制或部署 LangGraph？
开源基线评测仅能针对默认通用环境。BartsAI 为工程团队提供针对具体业务数据库连接、私有 API 调用权限及企业级发布门槛的专属 Launch Gate 准入审查。