LangGraph Runtime 是什么?一文讲清Runtime与Context的作用与用法!

本文深入讲解 LangGraph 中 Runtime 机制的设计与作用,重点分析其如何解决 State 臃肿与运行依赖混杂的问题。结合 LangGraph 执行流程与 RunnableConfig、Context、Runtime 三大核心组件,并通过代码示例演示节点如何访问运行时信息,帮助开发者理解短期记忆、外部存储与 Agent 上下文管理的最佳实践,是构建高可维护 AI Agent 与 RAG 系统的重要参考内容。


在 LangGraph 中,节点执行时往往不仅需要业务数据(状态,State),还需要用户 ID、线程 ID、数据库连接、存储对象等运行环境信息。如果把这些内容都塞进 State,状态会很快变得臃肿,而且很多资源对象本身也不适合序列化或写入检查点。

因此,LangGraph 提供了 Runtime。它的作用不是替代 State,而是为节点提供统一的运行时入口,让图中的业务状态与系统资源保持分离。

1. Runtime 要解决什么问题

先看一个典型场景。一个节点可能需要下面两类信息:

  • 业务数据,例如用户输入、历史消息、检索结果。
  • 运行信息,例如 user_id、thread_id、数据库连接、Store 对象。

这两类内容职责不同。如果全部混在 State 中,会带来两个问题:一是 State 不再纯粹,二是数据库连接这类资源很难安全地持久化。

Runtime 的意义就在于,把这些“运行依赖”从 State 中分离出来。

2. Runtime 和 State 有什么区别

两者最核心的区别是职责不同。

  • State 保存业务状态,也就是图在处理什么。
  • Runtime 提供运行环境,也就是节点依赖什么来完成处理。

换言之,State 负责数据流动,Runtime 负责环境注入。这样设计后,图的状态更清晰,节点也更容易维护。

3. LangGraph 中 Runtime 是如何工作的

在 LangGraph 中,调用 invoke() 时,框架会根据本次传入的 config 和 context,在节点执行阶段自动构造 Runtime 对象。

这里通常有三个角色:

  • State:保存输入、输出和中间业务结果。
  • Context:承载要注入 Runtime 的上下文,例如 user_id、数据库连接器。
  • RunnableConfig:承载本次调用配置,例如 thread_id。

节点执行时,就可以同时读取这三类来源的信息。

4. 示例:节点如何访问 Runtime

下面这段代码演示了最基本的用法:节点除了读取输入 state 之外,还从 config 中读取 thread_id,并从 runtime.context 中读取 user_id 和数据库名称。

 1 from dataclasses import dataclass
 2 from langc…
— 以上为试看内容(约 40%),开通会员后阅读全文 —