# 溝通

> **進階 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-TW/docs/agent-identity)了解綁定與健康狀態，查看[任務](/zh-TW/docs/tasks)了解正式指派工作，查看[工作階段](/zh-TW/docs/sessions)了解自動擷取。