# 沟通

> **高级 Runtime 工作流。** 沟通使用可选的 TokST CLI Runtime 和已连接智能体绑定。Cloud MCP 持续承担长期记忆与知识能力。

沟通为每个已创建智能体提供一个长期联系人，也支持让多个智能体加入共享群聊。消息通过经过认证的 WSS 通道投递，回复以流式方式返回同一对话。

## 沟通边界

沟通是独立的产品对象：

| 对象 | 用途 |
|---|---|
| 沟通 | 与一个智能体或群组直接对话协作 |
| 会话 | 自动采集和整理日常智能体使用过程 |
| 任务 | 明确分派工作，并保留执行状态与结果画布 |
| 记忆 | 保存跨对话长期有效的已确认知识 |

聊天消息不会自动创建任务、会话或记忆。需要进入正式执行或长期知识流程时，由用户明确创建任务或保存记忆。

## 联系人与私信

仪表盘 **沟通** 页面将已创建的智能体身份显示为联系人。当前工作区内，每组用户与智能体只对应一个长期私信。再次打开同一联系人会返回原对话，并保留按时间排序的历史记录。

联系人状态综合智能体绑定、设备连接、执行器健康、当前模型和回复状态。单独收到心跳不代表智能体具备实际执行能力。

## 群组

选择至少两个智能体联系人并设置名称，即可创建群组。全部成员共享群聊历史。普通群发消息对群组可见，并按照当前群组控制请求所选智能体回复。

智能体回复不会自动触发其他智能体持续回复。TokST 使用有限回合策略，让回复成为共享上下文，同时避免无限循环。

## 投递与流式回复

浏览器先保存用户消息，Server 再通过 WSS 投递执行通知。目标 Runtime 确认接收、启动已配置执行器、流式回写活动和回复，并持久化最终结果。

可见状态包括排队中、已投递、已接收、回复中、已回复、部分失败、失败和已取消。离线消息进入可靠队列，Runtime 重连后继续投递。群组内每个智能体具有独立执行结果，一个成员失败不会隐藏其他成员的成功回复。

## 智能体配置

每个联系人对应一个智能体绑定，包含稳定身份、昵称、设备、适配器、主模型、备用模型、Soul 和隔离的本机工作区。同一 Runtime 设备可以运行多个智能体，各绑定保持独立身份和工作目录。

在 **仪表盘 -> 智能体** 查看生效路由并诊断不可用联系人。在连接设备上使用 `tokst status`、`tokst doctor` 和 `tokst logs` 检查本机 Runtime。

## 历史、实时更新与本地缓存

消息按服务端时间排序，并通过限定范围的 Realtime 与 WSS 事件更新。浏览器缓存最近已授权消息，以便快速切换联系人，同时在后台同步最新记录。退出登录会清理当前账户的本地聊天缓存。

归档会从活跃列表移除聊天并保留历史。恢复后重新回到联系人或群组列表。永久删除仅在已归档页面提供，并要求明确确认。

## 故障恢复

回复失败时，先按故障阶段检查：

1. 确认设备和智能体绑定在线且具备执行能力。
2. 确认已配置模型与本机客户端认证有效。
3. 检查 WSS 连接、队列、执行器和项目路由诊断。
4. 仅重试失败的智能体回复；群组内其他成功回复继续保留。

查看[智能体身份](/zh-CN/docs/agent-identity)了解绑定与健康状态，查看[任务](/zh-CN/docs/tasks)了解正式分派工作，查看[会话](/zh-CN/docs/sessions)了解自动采集。