使用远程跟踪测试本地 Agent¶
概述¶
调试生产环境部署的 Agent 时,一个常见的工作流程是针对同一个线程测试相同 Agent 的本地版本,该本地版本可能包含修改。
为了支持这一点,LangGraph Studio 结合 LangSmith,允许您将 LangSmith 中跟踪的远程线程克隆到本地运行的 Agent 中。然后,可以使用此克隆的线程在 Studio 中重新运行特定节点。
要求¶
先决条件
- langgraph>=0.3.18
- langgraph-api>=0.0.32
- 在 LangSmith 中跟踪的线程。
- 一个本地运行的 Agent。请参阅此处了解设置说明。
- 请注意,您的本地 Agent 必须使用上述指定的
langgraph
和langgraph-api
版本。 - 远程跟踪中存在的节点必须存在于您的本地 Agent 的至少一个图中。
克隆线程¶
首先导航到 LangSmith 跟踪。您应该会看到一个“在 Studio 中运行”按钮。
这将提示您输入本地运行 Agent 的访问 URL。提供后,选择“在本地克隆线程”。如果您的 Agent 中有多个图,还会提示您选择要将此线程克隆到哪个图下。
选择后,您的本地 Agent 中将创建一个新线程,并重建线程历史记录以反映原始跟踪。
或者,如果您的跟踪源自部署在 LangGraph 平台上的 Agent,您可以“查看原始线程”以在 Studio 中打开实际部署的线程。