dify agent多轮记忆需配置session_id、messages和metadata三核心字段，并通过显式终止、ttl自动清理及上下文注入节点设置保留策略，同时确保webhook携带一致session_id并启用长期记忆。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让 Dify Agent 在多轮对话中准确记住用户意图、历史消息和中间状态，必须理解其上下文记忆的存储结构与会话生命周期控制逻辑，不能仅依赖默认配置。
理解上下文的三层构成
打开 Dify 后台的「应用设置 → 模型配置 → 上下文管理」，你会看到三个不可删除的核心字段：【session_id】、【messages】 和 【metadata】。其中 session_id 是会话唯一锚点，messages 是按时间顺序排列的完整对话数组，metadata 则是你唯一可自由写入自定义变量的位置——比如存用户选的城市、订单号或当前任务步骤。
注意：不要在 messages 里手动插入系统指令或摘要文本，Dify 会在推理前自动拼接 system_prompt，强行混入会导致提示词污染，模型可能复述你塞进去的“摘要”而不是生成真实响应。
控制会话生命周期的两种方式
方法一：显式终止会话
调用 Dify API 时，在请求体中加入 "close_session": true 字段。这会触发上下文立即销毁，且不可恢复——适合客服场景中用户明确说“不用了”或支付完成后的收尾。
方法二：设置 TTL 自动清理
在「环境变量」中添加 DIFY_SESSION_TTL=1800（单位秒），表示会话空闲超 30 分钟后自动清除 Redis 中的短期记忆。这个值必须小于你的 Redis key 过期时间，否则会话提前丢失。
保留关键对话历史的实操步骤
第一步：进入 Dify 应用编辑页 → 点击左侧「工作流」→ 找到「上下文注入」节点。
第二步：勾选「启用历史消息截取」→ 设置「保留最近 N 轮」为 6（客服类）或 12（任务型流程）。
第三步：在「高级选项」中开启「优先保留带 metadata 的消息」——这样当你在某轮回复中通过代码写入 {"step": "payment_confirmed"}，该条消息就不会被截断逻辑丢弃。
第四步：点击「保存并发布」，新会话将立即生效。
这一步操作起来很简单，但若跳过第四步直接测试，所有配置仍停留在草稿状态，不会影响任何线上会话。
修复上下文突然丢失的紧急操作
方法一：检查 Webhook 回调是否携带 session_id
如果你通过外部系统调用 Dify Agent，必须确保每次请求 header 中包含 X-Session-ID: sess_abc123，且该值全程不变。漏传或每次生成新 ID 都会导致 Dify 创建全新上下文。
方法二：验证长期记忆是否被误禁用
进入「知识库 → 用户级记忆」，确认开关已开启，并检查「匹配阈值」是否设得过高（建议保持默认 0.72）。若设为 0.95，早期对话几乎无法被语义召回，看起来就像“记性变差”。
