LangChain.js v1 记忆管理常用方法：createAgent 一站式方案

Agent 默认不跨会话记忆。每轮对话结束后LLM 不会保留上一轮的上下文信息。

这不是 bug。Agent 的底层设计就是无状态的——每次调用都是一张白纸，LLM 只看你当前传入的消息。让 Agent 有“记忆”，代表着在架构层面把状态管理补上。不过，LangChain.js 的答案在 v1 里变得很清晰：createAgent 统一入口。把短期记忆和长期记忆收敛到同一个 API。

从技术实现的角度。可以把 Agent 的记忆需求拆成三层：

• 会话连续性——同一轮对话别断掉，你说过的话下一句 Agent 还能引用。
• 跨会话持久化——明天打开 Agent 它还能认出你是谁、偏好什么。
• 行为记忆——Agent 记住哪些工具调用方法有效、哪些踩过坑，下次自动规避。

这三层正好对应 v1 记忆程序的技术栈：checkpointer 管会话连续性。store 管跨会话持久化，社区工具补充行为记忆。LangChain 的记忆程序从 v0 到 v1 经历了一次彻底重写。旧版 ConversationBufferMemory 已经废弃，取而代之的是基于 LCEL 和 LangGraph 的分层架构。怎么说呢，接下来逐层展开。

短期记忆的观点是，checkpointer 让 Agent 记住“刚才说了什么”

createAgent 是 v1 引入的统一 Agent 创建入口。它的 API 签名很简洁：

createAgent({
model。tools,systemPrompt?,checkpointer?,store，不过，,contextSchema?})

其中 checkpointer 负责短期记忆。配置 MemorySaver 后Agent 自动获得会话级消息持久化能力。每次调用时传入同一个 thread_id，Agent 就能在同一会话中保持上下文。

import { createAgent,tool } from "langchain";话说回来，import { MemorySaver } from "@langchain/langgraph";const agent = createAgent({
说到model。"openai:gpt-4o-mini",tools:,systemPrompt: "你是一个友好的助手，用中文回答。",checkpointer: new MemorySaver,});const config = { configurable: { thread_id: "session-123" } };// 第一轮
await agent.invoke(
{ messages: },config
);不过，// 第二轮 —— 自动记住上下文
const r2 = await agent.invoke(
{ messages: }。config
)，// → "你叫小明"

User Pain Point: 在没有 thread_id 隔离时不同使用者的对话相互污染，导致 Assistant 把别人的信息误报给当前使用者。

thread_id 是这里的关键。同一个 thread_idthread_idthread_idthread_id

MemorySaver 存的是 Checkpoint——完整的状态快照，包含消息历史、执行步骤和中间变量。也正因如此，服务重启后所有数据丢失，它只适合开发调试。