README 未说明具体依赖版本要求;调试与部署能力依赖 LangSmith 等配套产品,需另行接入;若想快速搭智能体,官方建议改用更高层的 Deep Agents 包
LangGraph 是构建有状态智能体的底层编排框架,让长任务能持久运行、断点续跑
用状态图编排有状态、可容错的 LLM Agent 工作流,支持循环、分支和人工介入,适合构建生产级多步智能体。
核心能力
- 用持久化执行让智能体失败后从断点自动恢复
- 支持在任意执行点检查并修改状态实现人工介入
- 提供短期工作记忆与跨会话长期持久记忆
- 可接入 LangSmith 追踪执行路径与状态转换
- 低层编排接口,可脱离 LangChain 独立使用
容易踩的坑
- cli==0.4.42langgraph-cli==0.4.422026-11-06 · 2026-11-06 03:04 UTC
查看更新说明
Changes since cli==0.4.41
- release(cli): 0.4.42 (#9611)
- feat(cli): add deploy metrics command (#9479)
- chore(deps): bump filelock and langgraph-api for security fixes (#9606)
- sdk==0.4.14langgraph-sdk==0.4.14最新正式版2026-11-06 · 2026-11-06 03:03 UTC
Changes since sdk==0.4.13
- release(sdk-py): 0.4.14 (#9610)
- feat(sdk-py): add strict_resume to runs.create, stream and wait (#9599)
- feat(sdk-py): add tools and lifecycle to StreamMode (#9601)
- cli==0.4.41langgraph-cli==0.4.412026-11-05 · 2026-11-05 02:30 UTC
查看更新说明
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)
- chore(deps): bump zod from 4.3.6 to 4.6.7 in /libs/cli/js-monorepo-example (#9431)
- 1.2.20langgraph==1.2.202026-11-05 · 2026-11-05 02:20 UTC
查看更新说明
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)
- sdk==0.4.13langgraph-sdk==0.4.132026-11-05 · 2026-11-05 02:16 UTC
查看更新说明
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)
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
Trusted by companies shaping the future of agents – including Klarna, Replit, Elastic, and more – LangGraph is a low-level orchestration framework for building, managing, and deploying long-running, stateful agents.
pip install -U langgraph
[!TIP] If you're looking to quickly build agents, check out Deep Agents — a higher-level package built on LangGraph for agents that can plan, use subagents, and leverage file systems for complex tasks.
For an equivalent JS/TS library, check out LangGraph.js and the JS docs.
Why use LangGraph?
LangGraph provides low-level supporting infrastructure for any long-running, stateful workflow or agent:
- Durable execution — Build agents that persist through failures and can run for extended periods, automatically resuming from exactly where they left off.
- Human-in-the-loop — Seamlessly incorporate human oversight by inspecting and modifying agent state at any point during execution.
- Comprehensive memory — Create truly stateful agents with both short-term working memory for ongoing reasoning and long-term persistent memory across sessions.
- Debugging with LangSmith — Gain deep visibility into complex agent behavior with visualization tools that trace execution paths, capture state transitions, and provide detailed runtime metrics.
- Production-ready deployment — Deploy sophisticated agent systems confidently with scalable infrastructure designed to handle the unique challenges of stateful, long-running workflows.
[!TIP] For developing, debugging, and deploying AI agents and LLM applications, see LangSmith.
LangGraph ecosystem
While LangGraph can be used standalone, it also integrates seamlessly with any LangChain product, giving developers a full suite of tools for building agents.
To improve your LLM application development, pair LangGraph with:
- Deep Agents – Build agents that can plan, use subagents, and leverage file systems for complex tasks.
- LangChain – Provides integrations and composable components to streamline LLM application development.
- LangSmith – Helpful for agent evals and observability. Debug poor-performing LLM app runs, evaluate agent trajectories, gain visibility in production, and improve performance over time.
- LangSmith Deployment – Deploy and scale agents effortlessly with a purpose-built deployment platform for long-running, stateful workflows. Discover, reuse, configure, and share agents across teams – and iterate quickly with visual prototyping in LangSmith Studio.
Documentation
- docs.langchain.com – Comprehensive documentation, including conceptual overviews and guides
- reference.langchain.com/python/langgraph – API reference docs for LangGraph packages
- LangGraph Quickstart – Get started building with LangGraph
- Chat LangChain – Chat with the LangChain documentation and get answers to your questions
Discussions: Visit the LangChain Forum to connect with the community and share all of your technical questions, ideas, and feedback.
Additional resources
- Guides – Quick, actionable code snippets for topics such as streaming, adding memory & persistence, and design patterns (e.g. branching, subgraphs, etc.).
- LangChain Academy – Learn the basics of LangGraph in our free, structured course.
- Case studies – Hear how industry leaders use LangGraph to ship AI applications at scale.
- Contributing Guide – Learn how to contribute to LangChain projects and find good first issues.
- Code of Conduct – Our community guidelines and standards for participation.
Acknowledgements
LangGraph is inspired by Pregel and Apache Beam. The public interface draws inspiration from NetworkX. LangGraph is built by LangChain Inc, the creators of LangChain, but can be used without LangChain.