连接后的使用方式¶
连接建立后,可以在 IM 中与智能体多轮对话,发送平台支持的文件,并接收智能体回复和产物。在 MOI 中打开该智能体的对应会话,可核对对话记录与处理结果。
发起对话¶
私聊:直接向机器人发消息。
群聊:在群里 @机器人 发消息;回复会出现在原位置,不会广播到其他群。
不同群聊和私聊分别维护当前会话。同一群里的成员会基于该群的当前会话继续交流;平台支持话题线程时,应在任务所在的线程中继续追问,并在切换会话后核对当前会话。
需要核查智能体执行过程时,回到 MOI 打开对应会话。IM 中的处理提示及回复形式因平台而异。
发送文件给智能体¶
在 IM 中发送文档或图片,并说明希望智能体完成的任务。文件类型、大小、附件数量和可下载范围受平台及连接权限限制。
发送后检查智能体回复,确认文件已被接收和处理。如果文件未被读取,先检查消息是否到达 MOI,再检查平台文件权限和页面中的错误提示。Slack 读取文件需要 files:read,见 Slack 配置指南。
接收智能体的产物¶
智能体可以把生成的文件、图片等产物发送回本次对话。成功发送的产物可在 IM 中查看或下载;如果发送失败,回到 MOI 的对应会话查看任务结果,并检查平台的文件权限和限制。Slack 发送文件需要 files:write。
会话命令¶
在 IM 中发送以下命令管理会话。命令必须单独作为一条消息发送,可在命令前或后带上 @机器人。发送后检查命令回复,确认操作结果。
命令 |
作用 |
|---|---|
|
查看当前对话的智能体 |
|
查看当前会话 |
|
列出可用会话的 ID,并标记当前会话 |
|
新建会话,并把当前对话切换到新会话 |
|
按会话 ID 切换会话( |
|
按会话 ID 重命名会话 |
先单独发送 !moi list sessions,从回复中复制目标会话 ID。假设返回的目标 ID 为 ctx_123,再单独发送:
!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 后再切换。
消息处理失败时,分别检查连接状态和对应任务结果。根据具体错误恢复连接、修正配置或重新提交任务。