跳到正文
Ankole

信号路由规则

信号路由规则决定一条消息交给哪个 Agent。当前,一条规则把一个聊天应用直接连接到一个 Agent;同一个 Agent 可以通过多条规则接入不同的聊天应用。

这里使用“信号”,是因为消息入口未来不只限于聊天渠道。后续可以通过路由表达式,根据频道、会话或其他条件选择 Agent,也可以把 Salesforce 等外部系统的事件交给 Agent 处理。

如果还没有准备好 Slack、Microsoft Teams、飞书 / Lark 或钉钉应用,请先按快速开始完成聊天渠道配置。

创建路由规则

  1. 打开 Console 的信号路由,选择新增路由规则
  2. 选择接收消息的 Agent 和聊天渠道适配器。
  3. 填写一个便于辨认的规则名称,例如 support-slack
  4. 选择群聊消息模式和记忆范围。
  5. 填写该聊天应用的凭证与连接信息,然后保存。
  6. 在对应的聊天应用中向机器人发送消息,确认指定 Agent 能够回复。

每个聊天 Bot 账号都应有自己的聊天应用和路由规则。如果希望多个 Agent 分别使用不同的 Bot 账号,请为每个 Bot 创建独立应用,再分别创建规则。这样可以单独轮换凭证,也不会把不同 Agent 的身份和消息混在一起。

选择群聊消息模式

Console 只会显示当前聊天渠道支持的选项:

模式 未明确提及 Agent 的群消息会怎样
仅处理明确提及 Agent 看不到这条消息,也不会回复。
记录未提及消息 消息会进入会话上下文,但不会立即唤醒 Agent。后续有人提及 Agent 时,它可以结合这些消息理解上下文。
可主动介入 Agent 会先判断自己是否应该加入对话;只有认为发言有帮助时才回复。

Slack、Microsoft Teams 和飞书 / Lark 支持以上三种模式。钉钉目前只能处理明确提及机器人的群消息,因此 Console 只会提供第一种模式。

“可主动介入”不是逢消息必答。它只是允许 Agent 在没人点名时作出判断。若 Agent 过于频繁地插话,应先收紧它的角色说明;若某个群只需要被动问答,直接改为“仅处理明确提及”。

选择记忆范围

共享会让群聊内容进入这个实例的共享记忆范围,适合需要跨会话积累信息的工作群。

仅本频道会把群聊内容留在该频道自己的记忆范围内,其他频道无法读取。涉及客户资料、项目保密信息或彼此隔离的团队时,应选择这一项。

修改或停用

重新配置规则时,可以更换目标 Agent、群聊消息模式、记忆范围或聊天应用凭证。更换目标 Agent 后,新消息会交给新的 Agent,已经发生的会话和记忆不会自动迁移。

删除规则会停止新的消息投递,但不会删除聊天应用本身。准备重新启用时,可以使用原来的应用重新创建规则。

排查没有回复的问题

  • 聊天渠道未出现:到Agent 能力库 → Control Plane Plugins启用对应插件,并按页面提示重启控制面。
  • 机器人收不到群消息:检查平台侧的事件订阅、权限和应用发布状态;钉钉群消息必须明确 @ 机器人。
  • 规则已保存但没有回复:确认目标 Agent 已启用、模型配置可用,并在规则列表中检查该规则是否可用。
  • 私聊正常、群聊不正常:检查群聊消息模式,以及机器人是否已加入目标群。

聊天渠道需要的权限、事件和凭证以快速开始中的平台步骤为准。