AI Agent / 系统课时

用 thread_id 延续多轮会话

用 thread_id 延续多轮会话

多轮智能体要真正“接着聊”,关键不是把历史消息再次手工拼进请求,而是让每次运行落到同一条持久化线程。本篇用一个不依赖模型 API 的最小图,验证相同 thread_id 会续接既有状态,而新的 thread_id 会得到独立会话。

学习目标

  • 理解 thread_id、checkpointer 与会话状态之间的关系
  • 用稳定的 thread_id 连续执行两轮请求并验证状态被续接
  • 避免每次请求新建线程或跨用户复用线程造成的记忆问题

thread_id 决定从哪条状态链继续

给图编译 checkpointer 后,LangGraph 会把同一线程产生的检查点组织在一起;运行时通过 configurable.thread_id 选择要读取和继续写入的线程。官方文档将 checkpointer 定义为线程级状态持久化机制,并说明 thread_id 是保存和读取检查点的关键标识。([Docs by LangChain][1])

thread_id 应代表“这一段会话”,而不是“某个用户永远只有一个 ID”。同一用户可以同时开启多个对话,因此更常见的做法是为每个会话生成一个稳定 ID,并在后续请求中持续复用。

相同与不同 thread_id 的检查点路由

用最小图验证会话续接

下面的示例不调用大模型,而是统计当前状态里已经出现过多少条用户消息。这样可以把“线程是否续接”与模型本身的上下文能力分开验证。

python
from langchain_core.messages import AIMessage
from langgraph.checkpoint.memory import InMemorySaver
from langgraph.graph import END, START, MessagesState, StateGraph


def reply(state: MessagesState):
    # MessagesState 会累积消息;这里用用户消息数量直接观察线程状态是否被恢复。
    user_messages = [m for m in state["messages"] if m.type == "human"]
    latest = user_messages[-1].content
    return {
        "messages": [
            AIMessage(
                content=f"thread has {len(user_messages)} user turns; latest={latest}"
            )
        ]
    }


builder = StateGraph(MessagesState)
builder.add_node("reply", reply)
builder.add_edge(START, "reply")
builder.add_edge("reply", END)
app = builder.compile(checkpointer=InMemorySaver())

same_thread = {"configurable": {"thread_id": "conversation-001"}}
new_thread = {"configurable": {"thread_id": "conversation-002"}}

for text in ["第一轮:记住代号 blue", "第二轮:现在继续"]:
    result = app.invoke({"messages": [{"role": "user", "content": text}]}, same_thread)
    print(result["messages"][-1].content)

result = app.invoke(
    {"messages": [{"role": "user", "content": "新会话"}]},
    new_thread,
)
print(result["messages"][-1].content)

预期输出:

text
thread has 1 user turns; latest=第一轮:记住代号 blue
thread has 2 user turns; latest=第二轮:现在继续
thread has 1 user turns; latest=新会话

第二次调用仍使用 conversation-001,所以运行前先加载该线程之前保存的消息,用户轮数从 1 增加到 2。第三次换成 conversation-002 后得到一条全新状态链,因此计数重新从 1 开始。

在应用层稳定传递 thread_id

实际服务通常在“创建会话”时生成一次 thread_id,把它和前端会话、数据库会话记录或 API 会话资源关联起来;后续每次调用都从这条记录取回同一个值。不要在每个请求处理函数里临时生成新 UUID,否则持久化层会把每次调用都当作新线程。

InMemorySaver 适合本地验证,但它把检查点放在进程内存中,进程重启后状态会消失。需要跨进程或跨重启延续会话时,应换成持久化 checkpointer;thread_id 的使用方式保持不变。([Docs by LangChain][2])

判断是否真的续接成功

最直接的验收不是看模型“好像记得”,而是检查同一 thread_id 下的状态确实在增长:第二轮能看到第一轮写入的消息,而新线程看不到旧线程内容。只要线程 ID 稳定、checkpointer 生效、访问控制正确,多轮会话的短期记忆就有了可验证的持久化基础。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 thread_id 延续多轮会话

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通