跳到主要内容
LangGraph 提供了时间旅行功能，可以从先前的检查点恢复执行，无论是重放相同的状态还是修改状态以探索替代方案。在所有情况下，恢复过去的执行都会在历史中产生一个新的分支。 要使用 LangGraph Server API（通过 LangGraph SDK）进行时间旅行：
  1. 使用 LangGraph SDK 的 client.runs.wait 或 client.runs.stream API，使用初始输入运行图。
  2. 识别现有线程中的检查点：使用 client.threads.get_history 方法检索特定 thread_id 的执行历史并找到所需的 checkpoint_id。或者，在您希望执行暂停的节点之前设置断点。然后您可以找到在该断点之前记录的最新检查点。
  3. （可选）修改图状态：使用 client.threads.update_state 方法修改检查点处的图状态并从替代状态恢复执行。
  4. 从检查点恢复执行：使用 client.runs.wait 或 client.runs.stream API，输入为 None，并提供适当的 thread_id 和 checkpoint_id。

​
在工作流中使用时间旅行

from typing_extensions import TypedDict, NotRequired
from langgraph.graph import StateGraph, START, END
from langchain.chat_models import init_chat_model
from langgraph.checkpoint.memory import InMemorySaver

class State(TypedDict):
    topic: NotRequired[str]
    joke: NotRequired[str]

model = init_chat_model(
    "claude-sonnet-4-5-20250929",
    temperature=0,
)

def generate_topic(state: State):
    """LLM call to generate a topic for the joke"""
    msg = model.invoke("Give me a funny topic for a joke")
    return {"topic": msg.content}

def write_joke(state: State):
    """LLM call to write a joke based on the topic"""
    msg = model.invoke(f"Write a short joke about {state['topic']}")
    return {"joke": msg.content}

# Build workflow
builder = StateGraph(State)

# Add nodes
builder.add_node("generate_topic", generate_topic)
builder.add_node("write_joke", write_joke)

# Add edges to connect nodes
builder.add_edge(START, "generate_topic")
builder.add_edge("generate_topic", "write_joke")

# Compile
graph = builder.compile()

​
1. 运行图

  • Python
  • JavaScript
  • cURL
from langgraph_sdk import get_client
client = get_client(url=<DEPLOYMENT_URL>)

# Using the graph deployed with the name "agent"
assistant_id = "agent"

# create a thread
thread = await client.threads.create()
thread_id = thread["thread_id"]

# Run the graph
result = await client.runs.wait(
    thread_id,
    assistant_id,
    input={}
)

​
2. 识别检查点

  • Python
  • JavaScript
  • cURL
# The states are returned in reverse chronological order.
states = await client.threads.get_history(thread_id)
selected_state = states[1]
print(selected_state)

​
3. 更新状态

update_state 将创建一个新的检查点。新检查点将与同一线程关联，但具有新的检查点 ID。
  • Python
  • JavaScript
  • cURL
new_config = await client.threads.update_state(
    thread_id,
    {"topic": "chickens"},
    checkpoint_id=selected_state["checkpoint_id"]
)
print(new_config)

​
4. 从检查点恢复执行

  • Python
  • JavaScript
  • cURL
await client.runs.wait(
    thread_id,
    assistant_id,
    input=None,
    checkpoint_id=new_config["checkpoint_id"]
)

​
了解更多

在 GitHub 上编辑此页面源文件。
以编程方式连接这些文档到 Claude、VSCode 等，通过 MCP 获取实时答案。
© . This site is unofficial and not affiliated with LangChain, Inc.