Skip to content

会话管理节点

会话用于组织用户与模型围绕同一主题产生的连续消息。会话管理节点操作会话对象本身,不直接创建具体消息。

资源库工作流试运行这些节点时,通常需要关联应用或具备会话上下文的运行环境;草稿试运行数据与线上运行数据应分别核对。

创建会话节点

创建会话节点在关联应用中创建一个空会话。conversationName 支持固定值或引用上游变量;同一应用、同一用户下存在同名会话时,节点返回已有会话 ID,并通过 isExisted 标识复用结果。

输入类型说明
conversationNameString,必填新会话名称;当前应用内应保持唯一

输出:

字段说明
isSuccess创建或查找操作是否成功
isExisted是否已经存在同名会话
conversationId新建或已存在会话的 ID

资源库工作流试运行时必须关联应用,只关联智能体不能替代应用关联。当 isExisted=true 时,应根据业务决定直接复用、生成新名称或停止流程。

创建会话节点配置面板

查看创建会话节点的完整配置、执行语义与验收方法 →

修改会话节点

修改会话节点在关联应用和当前用户作用域内变更会话名称。会话 ID、已有消息和历史记录保持不变。

输入类型说明
conversationNameString,必填当前会话名称
newConversationNameString,必填修改后的名称

输出 isSuccessisExistedconversationId。当前主运行链路不会用 isExisted 检查目标名称冲突;需要唯一名称时,应在修改前查询会话列表并显式校验。

修改会话节点配置面板

查看修改会话节点的完整配置、当前执行语义与验收方法 →

删除会话节点

删除会话节点根据 conversationName 删除当前应用和用户作用域内的会话,并同步删除其中的消息。当前执行器也兼容传入会话 ID,输出固定为 isSuccess

删除成功后,节点与产品界面没有恢复入口。执行前应优先使用可靠的 conversationId,并增加目标校验、确认和必要的审计记录。

删除会话节点配置面板

查看删除会话节点的完整配置、删除范围与验收方法 →

查询会话列表节点

查询会话列表节点读取当前应用、当前用户作用域内尚未删除的会话。当前节点没有需要手工配置的输入参数;应用和用户由运行上下文提供。

输出 conversationList,每项包含:

  • conversationName:会话名称。
  • conversationId:会话 ID。

当前实现按创建时间倒序返回第一页,默认最多 20 条,且不输出总数或下一页信息。展示列表时可以使用会话名称,后续节点应优先传递唯一的会话 ID;空列表应进入明确的空状态分支。

旧文档和节点面板仍有“静态会话、动态会话”的简介,但当前输出没有会话类型字段,流程不应依赖该分类。

查询会话列表节点配置面板

查看查询会话列表节点的完整作用域、数量限制与验收方法 →

推荐编排

查询会话列表 → 按名称或 ID 选择目标 → 创建/修改/删除会话 → 检查执行状态 → 再进入消息或会话历史处理。