会话历史节点

会话历史是大模型在当前多轮对话中可见的上下文消息，不等同于跨会话保存的长期记忆。

查询会话历史节点

查询会话历史节点返回指定会话中最近的若干条存储消息。当前运行时没有按“一问一答”分组，rounds 实际作为消息数量限制使用。

输入	类型	说明
conversationName	String，必填	会话名称，当前默认值为 Default；执行器也支持传入会话 ID
rounds	Integer，必填	最多返回的消息条数，运行时范围为 1～100；不是严格的对话轮数

输出 messageList，每项包含：

• role：消息角色。
• content：消息内容。

消息默认按创建时间倒序返回，最新消息在前；工具调用等中间消息也可能计入数量。传给模型前应根据业务需要重排为旧到新，并过滤无关、敏感或不受支持的角色。

查看查询会话历史节点的完整执行语义、数量限制与验收方法 →

清空会话历史节点

清空会话历史节点保留指定会话及其 ID、名称，清除该会话的全部有效消息，并切换到新的上下文段，使后续消息可以在同一会话中重新开始。

输入 conversationName，当前默认值为 Default，执行器也支持传入会话 ID；输出 isSuccess。目标不存在或资源库运行上下文没有会话项目时返回 false，已有但为空的会话重复清空仍可返回 true。

清空是有数据影响的操作。当前主数据库会给旧消息写入删除标记，内存模式会直接移除；“查询会话历史”和“查询消息列表”随后都不能再返回这些消息。执行前应确认会话 ID、用户身份和应用作用域，并完成必要归档。清空会话历史不等同于删除会话或删除长期记忆。

查看清空会话历史节点的完整清理范围、执行语义与验收方法 →

会话历史与长期记忆的选择

需求	使用能力
让模型理解当前对话前文	会话历史
在下一次新会话中仍记住用户偏好	长期记忆
删除当前会话上下文	清空会话历史
删除长期沉淀的个人信息	记忆库记录管理或相应业务流程