Appearance
会话管理节点
会话用于组织用户与模型围绕同一主题产生的连续消息。会话管理节点操作会话对象本身,不直接创建具体消息。
资源库工作流试运行这些节点时,通常需要关联应用或具备会话上下文的运行环境;草稿试运行数据与线上运行数据应分别核对。
创建会话节点
创建会话节点在关联应用中创建一个空会话。conversationName 支持固定值或引用上游变量;同一应用、同一用户下存在同名会话时,节点返回已有会话 ID,并通过 isExisted 标识复用结果。
| 输入 | 类型 | 说明 |
|---|---|---|
conversationName | String,必填 | 新会话名称;当前应用内应保持唯一 |
输出:
| 字段 | 说明 |
|---|---|
isSuccess | 创建或查找操作是否成功 |
isExisted | 是否已经存在同名会话 |
conversationId | 新建或已存在会话的 ID |
资源库工作流试运行时必须关联应用,只关联智能体不能替代应用关联。当 isExisted=true 时,应根据业务决定直接复用、生成新名称或停止流程。

修改会话节点
修改会话节点在关联应用和当前用户作用域内变更会话名称。会话 ID、已有消息和历史记录保持不变。
| 输入 | 类型 | 说明 |
|---|---|---|
conversationName | String,必填 | 当前会话名称 |
newConversationName | String,必填 | 修改后的名称 |
输出 isSuccess、isExisted、conversationId。当前主运行链路不会用 isExisted 检查目标名称冲突;需要唯一名称时,应在修改前查询会话列表并显式校验。

删除会话节点
删除会话节点根据 conversationName 删除当前应用和用户作用域内的会话,并同步删除其中的消息。当前执行器也兼容传入会话 ID,输出固定为 isSuccess。
删除成功后,节点与产品界面没有恢复入口。执行前应优先使用可靠的 conversationId,并增加目标校验、确认和必要的审计记录。

查询会话列表节点
查询会话列表节点读取当前应用、当前用户作用域内尚未删除的会话。当前节点没有需要手工配置的输入参数;应用和用户由运行上下文提供。
输出 conversationList,每项包含:
conversationName:会话名称。conversationId:会话 ID。
当前实现按创建时间倒序返回第一页,默认最多 20 条,且不输出总数或下一页信息。展示列表时可以使用会话名称,后续节点应优先传递唯一的会话 ID;空列表应进入明确的空状态分支。
旧文档和节点面板仍有“静态会话、动态会话”的简介,但当前输出没有会话类型字段,流程不应依赖该分类。

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