配置

外部消息配对

将外部用户或群绑定到指定 Agent 与会话。

配对决定消息交给谁

频道负责连接外部聊天平台;配对负责把具体外部用户或群绑定到 Nexus 的 Agent 与会话。只有频道在线,不足以保证消息进入正确工作上下文。

消息处理需要频道连接、配对关系、Agent 与会话均有效,并具备任务所需权限。

建立配对

  1. 先完成IM 通道的账号连接。
  2. 从自己的测试私聊或测试群发送一条普通消息。
  3. 打开 能力 → 配对,查看待处理关系;需要时使用页面提供的手动添加入口。
  4. 核对外部平台、用户或群,再选择应负责的 Agent 与会话。
  5. 确认后再发送一条测试消息,检查 Nexus 与外部聊天两边的记录。

绑定前先核对对象,避免把一个群的请求送进另一个客户或项目的会话。测试消息不应包含凭据或敏感材料。

变更已有关系

更换负责人或会话时,先明确新的消息应进入哪里,再修改配对并验证。修改绑定影响后续消息的去向;已有会话内容不会因此自动迁移。

相关 Agent 或会话被删除后,检查配对是否仍指向有效资源。重复创建 Agent 不能自动修复原有绑定。

外部审批与定时结果

来自外部聊天的权限确认只对准确配对的那段对话有效,不因为同一个平台账号下还有其他群聊就自动共享。

定时任务向外部发送结果时,也需要可用频道与正确配对。运行成功但送达失败,应先检查接收位置并重试送达,避免重新执行整项工作造成重复写入。

频道在线但无人处理

依次检查是否存在待确认配对、外部用户或群是否匹配、Agent 和会话是否有效,以及任务是否等待审批。这些配置无误时,再查看通道日志。