記憶與關鍵事件

記憶面板管兩類記憶：對話上下文（短期記憶、全量上下文）和關鍵事件（跨會話的長期業務記憶）。

短期記憶

短期記憶決定智慧體「記得住最近幾輪對話」：

由記憶面板的**「啟用最近 N 輪聊天記錄」**設定控制：可設定保留最近多少輪對話（一問一答為一輪），預設 30 輪。
關閉後，跨輪歷史不再帶給模型，智慧體會「忘記上一輪」。客戶反饋「不記得上一輪」時先查這裡。
偵錯 / 預覽態永遠是空記憶（每次乾淨上下文），屬正常。

全量上下文

短期記憶視窗裡，較老的輪次預設只保留「問什麼、答什麼」的純文字——當時呼叫了哪個工具、傳了什麼參數、拿到什麼結果，都不在歷史裡。全量上下文是疊加在短期記憶之上的一層：讓最近幾輪額外攜帶完整的工具呼叫軌跡（呼叫了哪個工具、入參、返回結果），使模型能準確記得自己剛才具體做過什麼。

由記憶面板的全量上下文設定控制（值顯示為「最近 N 輪」），預設 1 輪，範圍 0–5；0 表示關閉（更早的輪次僅保留問答文字）。
它與短期記憶輪數是兩個獨立設定、互不影響。
按輪計數（一問一答為一輪），不按回覆條數：同一輪裡若有多條回覆，不會被從中間切開——要麼整輪都帶工具軌跡，要麼都不帶。

什麼時候調大：模型「好像不記得上一輪到底呼叫了哪個工具、傳了什麼參數」時，先看這個值是不是設成了 0 或太小，調大即可。反過來，攜帶的輪數越多、Token 消耗漲得越快，不是越大越好——一般 1~2 輪就夠。

關鍵事件

關鍵事件是 LoopAgent 的跨會話、使用者級長期記憶（相當於工單）。模型在對話中主動為使用者建立 / 更新 / 查詢事件（如「退款處理」「帳戶異常」），同一使用者換個會話回來，還能看到並繼續推進。

事件掛在使用者身分上，跨該使用者的所有會話可見可改。
每輪系統提示會自動帶上該使用者最多 5 條未關閉事件；需要更多時模型會主動查詢。

與普通 Agent / FlowAgent 的區別：三類智慧體共用同一份關鍵事件配置（開關 + 事件類型），但寫入方式不同——LoopAgent 是模型在對話中同步寫入（本輪直接建 / 改事件）；普通 Agent / FlowAgent 是對話後由後台非同步抽取。關鍵事件的概念、事件類型配置、應用場景等通用內容，參見關鍵事件。

出現前提：兩個條件都要滿足

關鍵事件相關的工具要出現，需要同時滿足：

記憶裡的關鍵事件總開關打開；
事件類型分類裡至少配置了 1 個類型。

開關開著、但一個事件類型都沒建 → 關鍵事件工具不會出現，也不會注入歷史事件。這不是故障。

常見問題

「建立事件報參數錯誤」：多半是模型用的事件類型不在你配置的類型字典裡。核對模型傳的類型與設定頁類型名是否逐字一致（大小寫、空格敏感）。
「建了但回訪查不到」：優先懷疑使用者身分沒解析出來（匿名 / 渠道會話）。此時事件按會話兜底，跨會話檢索可能漏。