LangGraph
用于构建可持久恢复、具备记忆和人工介入能力的长运行状态化智能体工作流。
- Star 数
- ★ 45k
- 最近更新
- 今天
- License
- MIT
- 主语言
- Python
- FA 评分
- 44/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 需要让任务在故障后继续执行的应用开发者，可用它组织长运行的状态化工作流。
- 不适合
- 希望用少量代码快速搭建智能体的团队，应改用更高层的 Deep Agents
- 需要 JavaScript/TypeScript 支持的项目，本仓库只提供 Python 包
这个 Agent 能做什么，适合哪些场景？
LangGraph 是 LangChain Inc 构建的低层编排框架，用于构建、管理和部署长运行的状态化智能体。它面向工作流与智能体的执行状态，提供持久执行、人工介入以及短期和长期记忆等基础设施。工作流可在失败后从中断位置恢复，并允许人在执行过程中检查和修改状态。它可独立使用，也可与 LangChain、Deep Agents、LangSmith 和 LangSmith Deployment 配合；README 将 LangSmith 定位为调试、评估、可观测性和部署相关的配套产品。仓库提供 Python 包 langgraph，并将 JavaScript/TypeScript 用户指向独立的 LangGraph.js 仓库。
安装 langgraph 后，开发者使用它编排长运行、状态化的工作流或智能体。运行时可持久化执行状态，在失败后从离开的位置继续；人工可以在执行的任意时点检查或修改状态。框架支持短期工作记忆和跨会话的长期持久记忆。README 还说明可借助 LangSmith 跟踪执行路径、状态转换和运行时指标，并可使用 LangSmith Deployment 部署和扩展此类工作流；但未给出具体 Python 类、函数或首个可运行图的代码示例。
- 需要让任务在故障后继续执行的应用开发者，可用它组织长运行的状态化工作流。
- 需要在自动化流程执行中由审核人员查看并修改当前状态的团队，可利用人工介入机制。
- 需要同时保留当前推理上下文与跨会话信息的智能体开发者，可构建带短期和长期记忆的系统。
- 需要分析复杂智能体执行路径、状态转换和运行时指标的工程团队，可将工作流与 LangSmith 配合使用。
- 已使用 LangChain 组件、并希望为更复杂的智能体流程加入低层状态编排的开发者，可将其纳入现有生态。
如何安装或部署这个 Agent？
在具备 Python 与 pip 的环境中执行：
pip install -U langgraphREADME 未说明安装所需凭证，也未给出固定的 Python 版本要求。
如何使用这个 Agent？
README 说明 LangGraph 用于构建状态化工作流或智能体，并列出持久执行、人工介入和记忆能力，但没有提供可复制的 Python 导入、图定义、运行命令或首个工作调用。因此无法仅根据已提供材料给出经过证实的最小可运行调用。若需要调试、评估或部署，README 指向 LangSmith 与 LangSmith Deployment；相应配置、凭证和部署步骤未在材料中说明。
这个 Agent 有哪些优点和局限？
- 持久执行可使长运行流程在失败后从中断位置自动恢复。
- 人工介入允许在执行中的任意时点检查和修改智能体状态。
- 同时覆盖短期工作记忆与跨会话长期持久记忆，适合明确需要状态管理的流程。
- 可独立使用，也可接入 LangChain、Deep Agents、LangSmith 和 LangSmith Deployment 生态。
- 定位为低层框架；希望快速搭建高层智能体的用户，README 建议考虑 Deep Agents。
- 提供的材料没有最小 API 示例、具体图定义方式或首个工作调用，初始实现细节需从其他文档获取。
- 调试可视化、评估、生产可观测性和部署能力在 README 中关联 LangSmith 与 LangSmith Deployment，相关接入要求未在材料中展开。
- JavaScript/TypeScript 支持通过独立的 LangGraph.js 仓库提供，而不是此 Python 包内的同一接口。
这个 Agent 与同类方案有什么区别？
Deep Agents 是构建在 LangGraph 之上的高层包，面向需要规划、子智能体和文件系统的复杂任务；LangGraph 则提供更低层的状态化编排基础设施。对于 JavaScript/TypeScript，README 指向独立的 LangGraph.js 作为等价库。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| LangGraph 当前 | 44 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 45k | 今天 | Python | — |
| LangGraph JS | 55 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 3.4k | 今天 | TypeScript | — |
| Deuz SDK | 69 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 508 | 20 天前 | TypeScript | OpenAI API · Claude API |
| LlamaAgents | 66 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 464 | 6 天前 | Python | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示仓库未提供权限模型、用户确认机制、数据流透明性、敏感数据处理、依赖安全、外部影响、回滚或来源归属的说明。所有信任相关标准均未得到满足，因此得分为0。
自一致性：README描述为低层编排框架，与代码库结构一致，但未深入验证。依赖可用性：提供pip安装和依赖管理，但未提供依赖锁定或可用性保证。失败消息：未提供错误处理或失败消息的文档。
受众与场景：明确面向开发者，提供多种使用场景。能力边界：描述了功能范围，但未明确限制。触发精度：未提供触发机制或精确条件。环境适配：支持Python和JS，但未详细说明环境要求。
信息架构：文档结构清晰，有导航。安装说明：提供pip安装命令。命名稳定性：未提供命名约定或稳定性保证。示例与FAQ：提供示例和链接，但无FAQ。已知限制：未明确列出。许可证：MIT许可证，明确。版本与变更日志：有版本徽章，但未提供变更日志。维护责任：由LangChain Inc维护，但未验证。
输出可用性：提供API参考和文档，但未验证实际输出。边际价值：作为框架，提供独特功能，但未量化。成本效益：未提供性能或成本数据。
声明可追溯：README中的声明有文档链接，但未验证。跨来源佐证：有多个文档来源，但未独立验证。事实与推断分离：未明确区分事实和推断。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 源码中未见：来源归属可核验从官方仓库或包源安装，核对发布者和仓库地址，避免同名仿冒包。
- 未提供安全相关文档，如权限模型、数据流透明性、敏感数据处理等。
- 依赖安全未提及，未提供依赖锁定或漏洞扫描信息。
- 未提供回滚机制或来源归属说明。
- 未提供已知限制或失败消息文档。
- 发布者身份未验证，但未因此扣分。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
cli==0.4.41 langgraph-cli==0.4.41
发布说明摘录
Changes since cli==0.4.40 * release(cli): 0.4.41 (#9596) * chore(deps): bump langgraph from 1.2.3 to 1.2.14 in /libs/cli (#9512) * chore(deps): bump the minor-and-patch group in /libs/cli/js-examples with 9 updates (#9528) * chore(deps): bump the minor-and-patch group in /libs/cli/js-monorepo-example with 8 updates (#9526) * chore(deps): bump the uv group across 2 directories with 1 update (#9513) * chore(deps): bump langgraph-sdk from 0.4.5 to 0.4.6 in /libs/cli (#9514) * fix(cli): remove outdated deploy private-beta notice (#9506) …在 GitHub 查看 ↗ -
1.2.20 langgraph==1.2.20
发布说明摘录
Changes since 1.2.19 * release(langgraph): 1.2.20 (#9595) * feat(langgraph): give each interrupt() in a task its own id (#9589) * fix(langgraph): point the multiple-interrupts error at the current docs (#9590) * feat(langgraph): add a strict resume mode that refuses stale interrupt answers (#9574) * chore(deps-dev): bump types-requests from 2.33.0.20260906 to 2.33.0.20261006 in /libs/langgraph (#9535) * chore(deps-dev): bump pycryptodome from 3.23.0 to 4.2.0 in /libs/langgraph in the major group (#9534)在 GitHub 查看 ↗ -
sdk==0.4.13 langgraph-sdk==0.4.13
发布说明摘录
Changes since sdk==0.4.12 * release(langgraph): 1.2.20 (#9595) * release(sdk-py): 0.4.13 (#9594) * feat(sdk-py): add cancel_reason to Run (#9571) * docs(sdk-py): show the run's status in the stream example's end event (#9588) * feat(sdk-py): add select to threads.get_state and get_history (#9568)在 GitHub 查看 ↗