记忆与关键事件

记忆面板管两类记忆：对话上下文（短期记忆、全量上下文）和关键事件（跨会话的长期业务记忆）。

短期记忆

短期记忆决定智能体「记得住最近几轮对话」：

由记忆面板的**「启用最近 N 轮聊天记录」**设置控制：可设置保留最近多少轮对话（一问一答为一轮），默认 30 轮。
关闭后，跨轮历史不再带给模型，智能体会「忘记上一轮」。客户反馈「不记得上一轮」时先查这里。
调试 / 预览态永远是空记忆（每次干净上下文），属正常。

全量上下文

短期记忆窗口里，较老的轮次默认只保留「问什么、答什么」的纯文本——当时调了哪个工具、传了什么参数、拿到什么结果，都不在历史里。全量上下文是叠加在短期记忆之上的一层：让最近几轮额外携带完整的工具调用轨迹（调用了哪个工具、入参、返回结果），使模型能准确记得自己刚才具体做过什么。

由记忆面板的全量上下文设置控制（值显示为「最近 N 轮」），默认 1 轮，范围 0–5；0 表示关闭（更早的轮次仅保留问答文本）。
它与短期记忆轮数是两个独立设置、互不影响。
按轮计数（一问一答为一轮），不按回复条数：同一轮里若有多条回复，不会被从中间切开——要么整轮都带工具轨迹，要么都不带。

什么时候调大：模型「好像不记得上一轮到底调了哪个工具、传了什么参数」时，先看这个值是不是设成了 0 或太小，调大即可。反过来，携带的轮数越多、Token 消耗涨得越快，不是越大越好——一般 1~2 轮就够。

关键事件

关键事件是 LoopAgent 的跨会话、用户级长期记忆（相当于工单）。模型在对话中主动为用户建立 / 更新 / 查询事件（如「退款处理」「账户异常」），同一用户换个会话回来，还能看到并继续推进。

事件挂在用户身份上，跨该用户的所有会话可见可改。
每轮系统提示会自动带上该用户最多 5 条未关闭事件；需要更多时模型会主动查询。

与普通 Agent / FlowAgent 的区别：三类智能体共用同一份关键事件配置（开关 + 事件类型），但写入方式不同——LoopAgent 是模型在对话中同步写入（本轮直接建 / 改事件）；普通 Agent / FlowAgent 是对话后由后台异步抽取。关键事件的概念、事件类型配置、应用场景等通用内容，参见关键事件。

出现前提：两个条件都要满足

关键事件相关的工具要出现，需要同时满足：

记忆里的关键事件总开关打开；
事件类型分类里至少配置了 1 个类型。

开关开着、但一个事件类型都没建 → 关键事件工具不会出现，也不会注入历史事件。这不是故障。

常见问题

「创建事件报参数错误」：多半是模型用的事件类型不在你配置的类型字典里。核对模型传的类型与设置页类型名是否逐字一致（大小写、空格敏感）。
「建了但回访查不到」：优先怀疑用户身份没解析出来（匿名 / 渠道会话）。此时事件按会话兜底，跨会话检索可能漏。