# 连接后的使用方式

连接建立后，可以在 IM 中与智能体多轮对话，发送平台支持的文件，并接收智能体回复和产物。在 MOI 中打开该智能体的对应会话，可核对对话记录与处理结果。

## 发起对话

- **私聊**：直接向机器人发消息。
- **群聊**：在群里 @机器人 发消息；回复会出现在原位置，不会广播到其他群。

不同群聊和私聊分别维护当前会话。同一群里的成员会基于该群的当前会话继续交流；平台支持话题线程时，应在任务所在的线程中继续追问，并在切换会话后核对当前会话。

需要核查智能体执行过程时，回到 MOI 打开对应会话。IM 中的处理提示及回复形式因平台而异。

## 发送文件给智能体

在 IM 中发送文档或图片，并说明希望智能体完成的任务。文件类型、大小、附件数量和可下载范围受平台及连接权限限制。

发送后检查智能体回复，确认文件已被接收和处理。如果文件未被读取，先检查消息是否到达 MOI，再检查平台文件权限和页面中的错误提示。Slack 读取文件需要 `files:read`，见 [Slack 配置指南](slack.md)。

## 接收智能体的产物

智能体可以把生成的文件、图片等产物发送回本次对话。成功发送的产物可在 IM 中查看或下载；如果发送失败，回到 MOI 的对应会话查看任务结果，并检查平台的文件权限和限制。Slack 发送文件需要 `files:write`。

## 会话命令

在 IM 中发送以下命令管理会话。命令必须**单独作为一条消息**发送，可在命令前或后带上 @机器人。发送后检查命令回复，确认操作结果。

| 命令 | 作用 |
| --- | --- |
| `!moi list agent` | 查看当前对话的智能体 |
| `!moi list session` | 查看当前会话 |
| `!moi list sessions` | 列出可用会话的 ID，并标记当前会话 |
| `!moi new session [名称]` | 新建会话，并把当前对话切换到新会话 |
| `!moi switch session <会话ID>` | 按会话 ID 切换会话（`!moi use session` 作用相同） |
| `!moi rename session <会话ID> <新名称>` | 按会话 ID 重命名会话 |

先单独发送 `!moi list sessions`，从回复中复制目标会话 ID。假设返回的目标 ID 为 `ctx_123`，再单独发送：

```text
!moi switch session ctx_123
```

将 `ctx_123` 替换为实际 ID。切换会话使用 ID，不使用列表序号或会话名称。切换后，可发送 `!moi list session` 核对当前会话；后续输入将使用选中的会话。

## 会话与 MOI 网页互通

IM 对话与 MOI 中的会话关联。回到 MOI 时，打开同一智能体并查找对应的会话，核对已有消息后再继续追问。IM 中新建或切换过会话时，先用 `!moi list session` 确认当前会话 ID。

## 断开与重新启用

- 在 IM 双向通信窗口中点击**断开双向通信**并确认后，MOI 停止从该连接接收新消息。已接收消息对应任务的执行状态，需要到 MOI 中另行查看。
- 重新启用后，先发送测试消息并核对当前会话；需要继续已有会话时，查询会话 ID 后再切换。
- 消息处理失败时，分别检查连接状态和对应任务结果。根据具体错误恢复连接、修正配置或重新提交任务。

## 下一步

- [连接状态与问题排查](troubleshoot.md)