# LangGraph LangGraph 是 LangChain 推出的开源编排框架，专门用于构建运行时间长、具有状态且可控的 AI Agent。它非常适合那些需要基于图的控制、持久化执行、人机交互（Human-in-the-loop）审查、记忆功能以及生产级部署路径的 Agent 工作流开发者。 Canonical URL: https://aiidelist.com/zh/ide/langgraph Language: zh 更新日期: 2026-10-06 ## 概览 - 分类: Developer Workflow Tools - LangGraph 是一个开源的底层 Agent 编排框架，专为构建有状态、可控、长时间运行的 AI Agent 和工作流的开发者设计。 - 编辑器基础: Standalone - 平台: Python, JavaScript, TypeScript, Node.js, Web, Docker, Kubernetes, Cloud, Self-hosted, LangSmith, Local development, OpenAI-compatible providers - 开源: 是 - 本地模型支持: 是 - 自带 API 密钥: 是 ## 简评 当团队需要构建具备持久化、有状态、可人工审计且对路由和执行有显式控制的 AI Agent 时，LangGraph 是极佳选择。它不适合简单的聊天机器人、无代码助手，或是不想管理图架构、追求高层级角色抽象的团队。 ## 适合场景 - 有状态 AI Agent - 长时运行的 Agent 工作流 - 人机协作自动化 - 基于图的 Agent 编排 - 多步骤工具调用助手 - 具备追踪和评估功能的生产级 Agent 部署 - 需要对 Agent 状态和路由进行底层控制的团队 ## 优点 - 非常适合有状态、长时间运行且面向生产的 Agent 工作流。 - 开源 MIT 许可，支持 Python 和 JavaScript/TypeScript。 - 图模型为开发者提供了比黑盒 Agent 循环更高的控制力。 - 与 LangChain 集成良好，同时也可作为独立的编排运行时使用。 - LangSmith 为生产团队提供了追踪、Studio 可视化、评估和部署路径。 ## 局限 - 寻找 Cursor 或 Windsurf 等 AI 原生代码编辑器的开发者 - 需要终端优先的编程 Agent 的团队 - 不需要状态或图控制的简单提示词封装应用 - 寻找无代码聊天机器人构建器的非技术用户 - 偏好角色抽象（Crew）而非显式图设计的团队 - 无法在评估、观测和运维保障上投入资源的项​​目 - 不是 AI 代码编辑器、IDE 扩展或自主处理 GitHub 问题并提交 PR 的编程 Agent。 - 比许多 Agent 框架更偏底层，新用户需要理解状态、工具、路由和图设计。 - 生产环境部署和可观测性在配合 LangSmith 付费计划时最为强大。 - 如果不遵守严格的命名、测试和可视化规范，复杂的图可能变得难以维护。 - 模型、向量数据库和基础设施成本不包含在 LangGraph 本身内。 ## 为什么选择 LangGraph？ 当 AI Agent 需要表现得像一个可控的工作流，而不仅仅是单个助手的提示词时，LangGraph 就显得尤为重要。它为开发者提供了一种图结构（Graph），用以表示状态、步骤、路由、工具调用、中断以及可恢复的执行过程。 这使其与 AI 代码助手有所不同。代码助手是帮助开发者在编辑器中编写代码；而 LangGraph 则是帮助开发者构建 AI 产品背后的 Agent 运行时（Runtime）：即决定下一步发生什么、保存哪些状态、何时需要人工干预以及故障后如何恢复工作流的逻辑。 选择 LangGraph 的核心理由是“掌控感”。许多 Agent 框架为了降低上手难度而隐藏了底层架构。LangGraph 则采取了相反的立场：它让架构变得显式、可检查且可测试。当 Agent 需要处理真实业务而非演示对话时，这一点至关重要。 ## 核心工作流 一个典型的 LangGraph 项目通常从确定需要在工作流中持久化的“状态”开始。这些状态可能包括消息、工具执行结果、检索到的上下文、用户决策、中间计划、审批记录以及长期记忆。在此基础上，开发者为关键步骤创建图节点（Nodes），并为这些步骤之间的潜在转换创建边（Edges）。 设计过程随后演变为一个控制问题：哪些路径是确定性的？哪些决策应由模型做出？哪些操作需要人工检查点？哪些失败应该重试、分支或停止？LangGraph 的优势在于显式地回答这些问题，而不是将它们全部塞进一个庞大的提示词中。 一旦图在本地运行成功，团队通常会加入可观测性、数据集、评估方案和部署基础设施。根据生产需求，该工作流可以从本地的 Python 或 TypeScript 程序，迁移到接入 LangSmith 追踪的应用，再到独立的 Agent 服务器，最后部署到托管的 LangSmith Deployment 中。 ## 适用场景 LangGraph 适用于重视状态和控制的工作流。典型案例包括：支持类 Agent、研究类 Agent、代码助手、客户运营 Agent、文档审核流、合规性检查、内部 Copilot、长时间运行的任务自动化、智能体数据分析以及需要人工审批暂停的工作流。 当基础的 Agent 循环变得过于不可预测时，它尤其有用。如果 Agent 需要记住之前的步骤、基于工具结果进行分支、停下来等待审查、稍后恢复或协调子图，LangGraph 为开发者提供了直接建模这些行为的表达方式。 它不适用于简单的单次生成任务、基础的 RAG 聊天机器人，或仅需几次工具调用且无需持久化状态的场景。在这些情况下，直接使用 LangChain Agents、LlamaIndex、Haystack 或更简单的应用框架可能会更快。 ## 竞品对比 与 **CrewAI** 相比，LangGraph 更加显式且更偏底层。CrewAI 更容易被理解为由不同角色的 Agent 组成的团队；而当工作流需要精确的状态转换、条件路由、持久化执行和复杂的故障恢复时，LangGraph 是更好的选择。 与 **AutoGen** 相比，LangGraph 更倾向于生产环境的状态控制，而非仅限于对话式 Agent 团队。虽然 AutoGen 在历史上具有重要地位，但目前主要适用于现有项目和迁移规划。对于已经在使用 LangChain 生态的团队，LangGraph 是更积极的选择。 与 **Semantic Kernel** 相比，LangGraph 不绑定微软生态，且更侧重于图运行时。Semantic Kernel 适合通过插件方式集成到现有的 .NET、Python 或 Java 应用中。如果核心问题是 Agent 的状态、控制流和长时编排，LangGraph 则更具优势。 与 **LlamaIndex** 和 **Haystack** 相比，LangGraph 的核心并非检索。当难点在于文档摄取、索引和搜索质量时，这些工具通常更强。而当检索只是更大规模 Agent 工作流（涉及工具、审查、状态和部署）中的一部分时，LangGraph 表现更优。 ## 最佳配置建议 建议从简单的图和清晰的状态模型开始。避免将每一个提示词或辅助函数都变成节点。节点应该代表 Agent 工作流中具有意义的转换点，而不是每一行实现细节。 对于生产环境，应尽早定义人工检查点。LangGraph 让“人机交互”变得切实可行，但团队仍需制定策略：哪些操作需要审批、谁有权审批、哪些状态可以编辑，以及 Agent 随后应如何继续。 在可观测性方面，即便项目规模尚小，也应连接到 LangSmith。当团队可以比较不同版本的图演进过程时，追踪记录（Traces）的价值最大。等到上线后再添加追踪，会很难理解 Agent 为什么会做出某种决策。 在部署方面，选择符合风险特征的最轻量方案。本地和独立服务器适用于内部原型和受控基础设施。如果需要扩缩容、Studio 可视化和运营工作流，托管的 LangSmith Deployment 则更有吸引力。如果受限于合规、数据驻留或采购政策，则适合企业级私有化部署。 ## 迁移建议 从简单的 **LangChain Agent** 迁移到 LangGraph，通常从将隐藏的控制流显式化开始。确定现有 Agent 在何处检索、调用工具、重试、寻求澄清或停止，这些决策点通常会转化为图节点或条件边。 从 **CrewAI** 迁移需要思维模式的转变。CrewAI 围绕 Agent 和任务组织工作，而 LangGraph 围绕状态和转换组织。最简单的迁移方式是将每个 CrewAI 任务映射为一个受限的 LangGraph 节点，并用显式路由替换委派行为。 从 **AutoGen** 迁移通常意味着将对话转换为状态机。与其依赖 Agent 通过消息协同，不如直接定义状态、转换和终止条件。这通常能提高可预测性，但可能需要重新设计部分工作流。 从**自定义工作流引擎**迁移应从持久化和中断需求入手。如果当前系统已在使用队列、作业和数据库，应在模型驱动路由和有状态 Agent 行为能带来明确价值的地方引入 LangGraph，而不是用它替代所有的后端编排。 ## 开发中的权衡 LangGraph 的主要优势也是其主要的开发代价：显式控制。开发者获得了更强大的能力，但也必须做出更多的架构决策。设计拙劣的图可能会像混乱的代码一样令人困惑。 该框架对那些坚持使用真实追踪和典型失败案例测试工作流的团队更有利。一个在白板上看起来优雅的图，在工具返回部分数据、用户中途打断、模型选择了意外路由或外部服务超时时，仍可能失效。 实际结论是：LangGraph 适合严肃的 Agent 工程开发。它不是创建玩具聊天机器人的最快路径，也不是面向开发者的 IDE。它是一个用于构建生产级 AI 产品背后的有状态 Agent 系统的框架。 ## 功能 ### 基于图的 Agent 运行时 - StateGraph 和函数式 API 模式 - 节点、边、条件路由和子图 - 长时间运行的有状态 Agent 工作流 - 对 Agent 架构的底层控制 ### 可靠性与控制 - 持久化执行与持久化存储 - 检查点、存储和记忆功能 - 人机交互（Human-in-the-loop）中断 - 流式处理、时光倒流（Time Travel）和容错模式 ### 开发者工具 - Python SDK - JavaScript 和 TypeScript SDK - 用于本地开发和 Docker 构建的 LangGraph CLI - 用于可视化调试和实时迭代的 LangSmith Studio ### 部署与可观测性 - 用于托管 Agent 的 LangSmith Deployment - 支持 Docker、Compose 或 Kubernetes 的独立 Agent 服务器 - 混合部署和私有化企业部署选项 - 通过 LangSmith 进行追踪、评估、提示词管理和监控 ## 价格 freemium - LangGraph OSS: Free — 采用 MIT 许可的开源库，用于在 Python 和 JavaScript/TypeScript 中构建有状态的 Agent 工作流。 - LangSmith Developer: $0 — 席位/月 — 免费版 LangSmith 计划，支持 1 名用户，每月 5,000 条基础追踪，超出部分按量计费。 - LangSmith Plus: $39 — 席位/月 — 团队版计划，每月 10,000 条基础追踪，支持 LangSmith Deployment、沙盒环境、引擎、邮件支持及一个免费的开发级部署。 - LangSmith Enterprise: Custom — 合约计费 — 企业版计划，支持私有化和混合部署选项、自定义 SSO 和 RBAC、支持级 SLA 以及自定义席位和工作区。 价格核对日期: 2026-07-08 ## 支持的模型 - OpenAI - Anthropic - Azure OpenAI - Google Gemini - AWS Bedrock - Hugging Face - OpenRouter - Ollama - Mistral ## 隐私与数据处理 LangGraph 开源版在开发者的自有环境中运行，隐私性取决于所配置的模型提供商、工具、存储、检查点、追踪和部署架构。LangSmith 追踪会记录图状态和 LLM 提示词，但可通过 LANGSMITH_TRACING=false 关闭；除非开启追踪或外部服务，否则本地开发数据保留在本地机器上。LangSmith 声明客户数据不用于训练模型，但团队在发送敏感数据前仍应审查提供商的路由、追踪保留、脱敏和部署设置。 ## 企业功能 - LangSmith 可观测性和评估 - LangSmith Studio 可视化调试 - LangSmith Deployment 托管 Agent 服务 - 独立 Agent 服务器部署 - 在客户基础设施中部署 Agent 服务器的混合模式 - 企业版私有化部署 LangSmith - 自定义 SSO 和 RBAC 权限控制 - 企业版支持级 SLA - 追踪脱敏和敏感数据控制 - 追踪和检查点的数据保留控制 - 支持 OpenTelemetry 的生产监控模式 - 用于构建、部署、Dockerfile 和本地服务器工作流的 LangGraph CLI ## 替代工具 - CrewAI - Microsoft Agent Framework - AutoGen - Semantic Kernel - LlamaIndex - Haystack ## 资料来源 - [官方网站](https://www.langchain.com/langgraph) - [LangGraph 官网](https://www.langchain.com/langgraph) - [LangGraph Python 文档](https://docs.langchain.com/oss/python/langgraph/overview) - [LangGraph JavaScript 文档](https://docs.langchain.com/oss/javascript/langgraph/overview) - [LangGraph GitHub 代码仓](https://github.com/langchain-ai/langgraph) - [LangGraph.js GitHub 代码仓](https://github.com/langchain-ai/langgraphjs) - [LangGraph MIT 许可证](https://github.com/langchain-ai/langgraph/blob/main/LICENSE) - [LangSmith 价格页](https://www.langchain.com/pricing) - [LangSmith Deployment 文档](https://docs.langchain.com/langsmith/deployment) - [LangGraph CLI 文档](https://docs.langchain.com/langsmith/cli) - [适用于 LangGraph 的 LangSmith Studio](https://docs.langchain.com/oss/python/langgraph/studio) - [数据存储与隐私文档](https://docs.langchain.com/langsmith/data-storage-and-privacy) - [LangChain 模型集成说明](https://docs.langchain.com/oss/python/langchain/models) 最近核对日期: 2026-07-08 ## 更新记录 - 2026-07-08: 基于 LangGraph 官方产品页、Python 和 JavaScript 文档、GitHub 仓库、LangSmith 定价及部署文档、CLI 和 Studio 文档以及数据隐私文档创建目录条目。