短期记忆

作用

短期记忆主要用于帮助 Agent 保持当前会话内的上下文连续性，使 Agent 能够基于已有消息理解当前任务状态、历史交互内容以及用户后续请求。

特点

• 保存原始消息：短期记忆直接保存交互过程中产生的消息，不对消息内容进行长期记忆抽取或结构化转换。
• 支持多种消息角色：支持user、assistant、system、tool等不同角色消息。
• 会话级隔离：消息按Session进行管理和查询，不支持跨Session查询短期记忆。
• 支持分页和排序查询：可按消息顺序或消息时间进行排序，并支持分页获取会话中的消息记录。

生命周期

短期记忆支持配置消息保留期（TTL，Time To Live），以控制原始事件消息在存储中的存活时长。TTL 支持以下两种单位配置：

• 天：取值范围为1～365天，默认值90天。
• 小时：取值范围为1～8760小时（1小时～365天），默认值2160小时（90×24）。适用于需要严格控制数据留存时长的场景，如临时对话、敏感场景会话等。

• TTL从消息写入时开始计时，超过TTL的消息将被系统自动硬删除（从数据库中物理清除），查询时返回“消息不存在”。
• 在消息过期前，消息可被长期记忆提取策略处理并提取为长期记忆。若TTL设置过短（如1 小时），需确保长期记忆提取任务在此时间内完成，否则消息可能在提取前被删除。
• TTL配置更新后，最多需要30分钟生效（缓存过期后重新读取配置）。如需立即生效，可重启access服务。