Skip to main content
Alpha 版本提示: 本文档涵盖的是 v1-alpha 版本。内容尚不完整,且可能随时变更。如需查阅最新稳定版本,请参阅 v0 版本的 LangChain Python 文档LangChain JavaScript 文档
在完成 LangGraph 代理的原型开发后,自然的下一步是为其添加测试。本指南介绍编写单元测试时可使用的一些实用模式。 请注意,本指南专为 LangGraph 设计,涵盖具有自定义结构图的测试场景。如果您刚刚入门,建议先查看这一章节,它使用的是 LangChain 内置的 create_agent() 方法。

前置条件

首先,请确保已安装 pytest

快速入门

由于许多 LangGraph 代理依赖状态管理,一个实用的模式是在每个测试开始前创建图结构,并在测试中使用新的检查点实例进行编译。 以下示例展示了一个简单的线性图,它依次经过 node1node2,每个节点都会更新状态键 my_key

测试单个节点和边

编译后的 LangGraph 代理通过 graph.nodes 暴露每个节点的引用。您可以利用这一点单独测试代理中的特定节点。请注意,这种方式会绕过编译图时传入的任何检查点器:

部分执行

对于由大型图结构组成的代理,您可能希望测试代理中的部分执行路径,而非完整的端到端流程。在某些情况下,从语义上将这些部分重构为子图可能更合理,这样您就可以像平常一样独立调用它们。 但如果您不希望更改代理图的整体结构,可以利用 LangGraph 的持久化机制,模拟代理在目标段落开始前暂停、并在目标段落结束后再次暂停的状态。步骤如下:
  1. 使用检查点器编译您的代理(测试时使用内存检查点器 InMemorySaver 即可)。
  2. 调用代理的 update_state 方法,并将 as_node 参数设置为您希望测试起始节点之前的那个节点名称。
  3. 使用与更新状态时相同的 thread_id 调用代理,并设置 interrupt_after 参数为您希望停止执行的节点名称。
以下示例仅执行线性图中的第二个和第三个节点: