在 Pregel 模型中静态上下文是一个专门设计的依赖注入容器。它的出现是为了解决在复杂的图计算中如何优雅地处理“不属于图状态但Node运行又必须依赖的外部环境信息”这一痛点。这些数据具有一个共同的性质那就是在整个运行生命周期内只读且固定比如身份信息当前发起请求的user_id、org_id。外部客户端已实例化的db_connection、redis_client、vector_store。策略约束当前任务的safety_level或budget_limit。静态上下文是 Pregel 运行时提供的一个类型安全的环境变量容器。它将执行环境Context与业务轨迹State物理隔离使得大型 Agent 系统的架构更加模块化也更容易在复杂的生产环境下进行测试和调试。不同于以往字典形式的配置静态上下文采用强类型 Schema 定义方法。由于其静态只读的特性它在整个生命周期内保持一致性。静态上下文具有单次运行锁定机制这保证Pregel对象一旦被调用上下文对象在所有Node、所有 Superstep中引用的是同一个内存地址。它的非持久化特性进一步确保它不会被写入Checkpoint所以当Pregel因为错误停止并从断点恢复时我们必须重新提供一个相同的上下文对象。综上所示静态上下文作为非序列化的、运行时的旁路注入而存在。静态上下文在Pregel被作为Runtime的一部分来传递的。如下所示的Runtime类的泛型参数ConextT指的就是静态上下文数据类型。除了返回该上下文的context字段Runtime还具有额外三个字段分别返回用于长期存储的store字段返回一个BaseStore对象、实现“custom”流模式的stream_writer字段返回一个StreamWriter对象以及提供当前会话上一个返回值的previous字段。/* by 01130.hk - online tools website : 01130.hk/zh/camelcase.html */ dataclass(**_DC_KWARGS) class Runtime(Generic[ContextT]): context: ContextT field(defaultNone store: BaseStore | None field(defaultNone) stream_writer: StreamWriter field(default_no_op_stream_writer) previous: Any field(defaultNone)Pregel节点的处理函数读取静态上下文比较繁琐以为除了承载输入的参数一般是一个字典我们只能额外定义一个RunnableConfig类型的参数意味着基本上出原始输入外的其他任务信息都得从这个RunnableConfig配置中提取。RunnableConfig是一个字典所以我们要提取所需数据的前提是得预先知道对用得Key。这样设计也能理解因为LangGraph.Prege在整个LangChain宇宙中作为执行引擎而存在它相当于LangChain体系的内核。Pregel提供的API本就不是针对Agent应用开发者对开发者友好不是Pregel得设计目标保持这个内核足够简洁更重要。RunnableConfig对象会贯穿整个Pregel引擎的执行上游流程利用这个它像下游传递所需的组件和控制信息传递的信息大都被至于configurable子节点下。如果对应的Key以__pregel_作为前缀表示该条目其实是由Pregel内部使用的。Runtime对应的Key为__pregel_runtime。如下这个例子演示了如何声明、指定和读取静态上下文。我们定义一个承载基本用户信息的UserInfo数据类型作为静态上下文的Schema。作为Pregel唯一的Node其处理函数提供了一个RunnableConfig类型的参数我们从中提供作为运行时的Runtime对象进而得到作为静态上下文的UserInfo对象。/* by 01130.hk - online tools website : 01130.hk/zh/camelcase.html */ from langchain_core.runnables import RunnableConfig from langgraph.pregel import Pregel, NodeBuilder from typing import Any, Literal from langgraph.channels import LastValue from langgraph.runtime import Runtime from dataclasses import dataclass dataclass class UserInfo: id: str name: str gender: Literal[male, female] def handle(args: dict[str, Any], config: RunnableConfig) - str: runtime: Runtime config[configurable][__pregel_runtime] return runtime.context.__repr__() node (NodeBuilder() .subscribe_only(start) .write_to(output) .do(handle)) app Pregel( nodes{body: node}, channels{start: LastValue(None), output: LastValue(str)}, input_channels[start], output_channels[output], context_schemaUserInfo, ) user UserInfo(id123, nameAlice, genderfemale) result app.invoke(input{start: None}, contextuser) assert result[output] user.__repr__()在创建Pregel对象的时候作为静态上下文的UserInfo类型直接以构造函数的context_schema参数进行声明。在调用其invoke方法的时候就通过context参数将指定的UserInfo对象作为静态上下文传递。静态上下文的设计初衷就是为了规避序列化的限制。它允许我们将复杂的、重量级的、带有外部依赖的对象的直接注入而不会破坏 Pregel 模型对状态一致性和可持久化的要求。