如何将线程级别持久化添加到子图中¶
设置¶
首先,让我们安装所需的包
为 LangGraph 开发设置 LangSmith
注册 LangSmith,以便快速发现问题并提高 LangGraph 项目的性能。LangSmith 允许您使用跟踪数据来调试、测试和监控您使用 LangGraph 构建的 LLM 应用程序——请此处了解更多如何开始。
定义具有持久性的图¶
要为包含子图的图添加持久性,只需在编译父图时传入一个检查点器即可。LangGraph 会自动将检查点器传播到子图。
注意
您不应在编译子图时提供检查点器。相反,您必须定义一个单个的检查点器,并将其传递给 parent_graph.compile()
,LangGraph 会自动将检查点器传播到子图。如果您将检查点器传递给 subgraph.compile()
,它将被简单忽略。这同样适用于您添加调用子图的节点函数的情况。
让我们定义一个包含单个子图节点的简单图,以展示如何做到这一点。
API 参考: START | StateGraph | MemorySaver
from langgraph.graph import START, StateGraph
from langgraph.checkpoint.memory import MemorySaver
from typing import TypedDict
# subgraph
class SubgraphState(TypedDict):
foo: str # note that this key is shared with the parent graph state
bar: str
def subgraph_node_1(state: SubgraphState):
return {"bar": "bar"}
def subgraph_node_2(state: SubgraphState):
# note that this node is using a state key ('bar') that is only available in the subgraph
# and is sending update on the shared state key ('foo')
return {"foo": state["foo"] + state["bar"]}
subgraph_builder = StateGraph(SubgraphState)
subgraph_builder.add_node(subgraph_node_1)
subgraph_builder.add_node(subgraph_node_2)
subgraph_builder.add_edge(START, "subgraph_node_1")
subgraph_builder.add_edge("subgraph_node_1", "subgraph_node_2")
subgraph = subgraph_builder.compile()
# parent graph
class State(TypedDict):
foo: str
def node_1(state: State):
return {"foo": "hi! " + state["foo"]}
builder = StateGraph(State)
builder.add_node("node_1", node_1)
# note that we're adding the compiled subgraph as a node to the parent graph
builder.add_node("node_2", subgraph)
builder.add_edge(START, "node_1")
builder.add_edge("node_1", "node_2")
我们现在可以使用内存检查点器(MemorySaver
)来编译图。
checkpointer = MemorySaver()
# You must only pass checkpointer when compiling the parent graph.
# LangGraph will automatically propagate the checkpointer to the child subgraphs.
graph = builder.compile(checkpointer=checkpointer)
验证持久性是否有效¶
现在让我们运行图,并检查父图和子图的持久化状态,以验证持久性是否有效。我们应该期望在 state.values
中看到父图和子图的最终执行结果。
{'node_1': {'foo': 'hi! foo'}}
{'subgraph_node_1': {'bar': 'bar'}}
{'subgraph_node_2': {'foo': 'hi! foobar'}}
{'node_2': {'foo': 'hi! foobar'}}
graph.get_state()
来查看父图状态。
要查看子图状态,我们需要做两件事
- 找到子图最近的配置值
- 使用
graph.get_state()
检索该最近子图配置的值。
要找到正确的配置,我们可以检查父图的状态历史,并找到我们在从 node_2
(包含子图的节点)返回结果之前的状态快照
状态快照将包含接下来要执行的 tasks
列表。使用子图时,tasks
将包含我们可以用来检索子图状态的配置
{'configurable': {'thread_id': '1',
'checkpoint_ns': 'node_2:6ef111a6-f290-7376-0dfc-a4152307bc5b'}}
如果您想了解更多关于如何修改子图状态以用于人在环路工作流程的信息,请查看这篇操作指南。