管理渠道会话

渠道会话保存飞书、QQ 等消息入口中的对话上下文。渠道用户不需要填写 Invoke API 的 session_id；平台根据渠道账号、用户或群聊选择当前会话。

平台处理一条渠道消息时，需要分别确定两件事：由哪个智能体实例回复，以及本次回复接着哪段对话历史。用户绑定确定智能体实例，渠道会话确定对话历史。切换会话不会更换智能体实例。

如果不同用户只需要各自的对话历史，可以让渠道绑定一个共享智能体实例，并为用户保留不同渠道会话。只有需要分别管理实例参数、能力资源或生命周期时，才需要通过模板绑定为用户创建专属实例。

通过一个例子理解渠道会话

假设小王第一次在飞书中使用“报销助手”：

1. 小王发送 /init。平台为小王创建或选择智能体实例 A，并保存用户绑定。
2. 小王询问差旅报销，消息和回复保存在会话 1。
3. 小王发送 /session new 发票问题，再询问发票。用户绑定仍指向实例 A，但当前对话历史变成会话 2。
4. 小王发送 /session use 1 后，实例 A 会再次使用会话 1 的历史继续回答。

一条消息同时使用用户绑定和当前渠道会话：

因此，/init 解决“这位用户使用哪个智能体实例”，/session 解决“这位用户当前继续哪段对话”。删除或切换渠道会话不会删除用户绑定或智能体实例。

理解默认会话

渠道账号处理一位单聊用户的第一条消息时，会为该用户准备默认会话。后续消息继续当前会话，直到用户创建或切换到另一段会话。

不要把离开聊天或长时间没有发送消息当作新会话。开始新的主题或业务任务时，使用 /session new；需要移除当前会话历史时，使用 /session clear。群聊不支持创建多段会话，需要清理当前群聊上下文时使用 /session clear。

使用模板绑定时，用户仍需先发送 /init 创建并绑定专属智能体实例。/init 管理用户与智能体实例的关系；/session 管理该实例中的对话上下文。

管理单聊会话

在支持渠道指令的单聊中，可以发送：

命令	结果
/session new [名称]	创建一段新会话并切换到该会话；不填写名称时，平台自动生成名称
/session list	列出该用户的会话并标记当前会话
/session use <序号>	按列表中的序号切换当前会话
/session clear	清空当前会话的对话历史，后续消息仍使用当前会话
/session fix	清除当前会话卡住的处理状态，然后重新发送消息

需要从干净的上下文开始且保留原会话时，使用 /session new。需要保留当前会话但移除其中的对话历史时，使用 /session clear。不要等待会话因空闲自动切换或清空。只有消息一直停留在处理中且无法继续时才使用 /session fix。

管理群聊会话

群聊按渠道账号和群聊选择对话上下文，不提供单聊中的多会话切换。群聊只支持：

• /session clear：清空当前群聊会话的对话历史。
• /session fix：清除卡住的处理状态。

在群聊中使用 new、list 或 use 不会创建或切换单聊会话。

在控制台检查渠道会话

1. 打开 渠道账号，进入目标账号详情页。
2. 选择 会话管理。
3. 按渠道用户检查会话数量、当前会话和更新时间。
4. 需要核对消息路由到哪个智能体实例时，再打开 用户绑定。

会话管理 用于查看和调整渠道会话选择。需要清空用户当前对话历史时，让该用户在对应聊天中发送 /session clear。

区分会话、绑定、实例和记忆

渠道会话、用户绑定、智能体实例和记忆库分别管理对话、路由、运行和跨会话信息。

对象	作用	改变它会发生什么
渠道会话	选择当前对话上下文	新建或切换会话不会创建新的智能体实例
用户绑定	把渠道用户路由到专属智能体实例	删除绑定不会删除原智能体实例
智能体实例	运行模型、提示词和已配置能力	一个实例可以依次处理多段渠道会话
记忆库	保存可供后续交互检索的记忆条目	新建或清空渠道会话不会自动创建或清空记忆库

需要管理渠道绑定和实例生命周期时，参见管理渠道账号与用户绑定。需要验证跨会话记忆时，参见验证记忆行为。

处理常见问题

• 用户没有专属智能体实例：先按模板绑定流程发送 /init，不要用 /session new 代替初始化。
• 回复沿用了不需要的上下文：使用 /session new 开始另一段会话，或使用 /session clear 清空当前历史。
• 消息一直停留在处理中：先等待当前回复；确认无法继续后使用 /session fix，再重新发送消息。
• 切换后回复不符合预期：使用 /session list 确认当前会话，并在 用户绑定 中核对目标智能体实例。

渠道账号、绑定模式和 /init 流程参见通过渠道提供智能体。API 调用使用另一套会话管理方式，参见管理 API 会话、调用任务和中断。