消息渠道¶

消息渠道（Channel）用于将 Agent 接入微信、钉钉、飞书等 IM 平台。接入后，团队可以在熟悉的群聊或会话中向 Agent 提问、发起协作，也可以让 Agent 将任务结果推送到指定消息渠道会话。

适用场景¶

消息渠道适合以下场景：

• 在研发、运维、值班或项目群中直接向 Agent 提问，让 Agent 参与日常协作；
• 告警、故障排查或变更跟进时，让 Agent 在群聊中补充分析、总结结论或给出下一步建议；
• 自动化任务执行完成后，将日报、巡检结果、风险清单或分析报告推送到指定群聊；
• 团队成员不进入控制台，也可以在外部 IM 中与 Agent 沟通，延续已有工作习惯；
• 为不同 Agent 接入不同群聊或账号，让职责边界和协作范围更清晰。

推荐使用流程¶

建议按以下顺序配置和使用消息渠道：

flowchart LR
  A[准备外部消息渠道] --> B[Agent 侧新增消息渠道配置]
  B --> C[在目标群聊或私聊中<br/>向 Agent 发送消息]
  C --> D[系统建立或复用<br/>消息渠道会话]
  D --> E[在外部 IM 中<br/>继续与 Agent 协作]
  D --> F[在自动化或任务接入中<br/>选择一个或多个具体会话]
  F --> G[结果仅投递到<br/>所选会话]

添加并启动消息渠道只完成 Agent 与外部机器人账号的连接。在目标对话中发送消息后，系统才会建立或复用一个可供自动化、任务接入选择的消息渠道会话。

添加消息渠道¶

进入某个 Agent 的工作台，打开消息渠道后，按页面提示接入：

• 点击新建渠道；
• 选择要接入的平台，例如微信、钉钉或飞书；
• 按平台要求填写应用凭证，或使用扫码登录完成授权；
• 完成授权后，消息渠道会出现在已接入列表中；
• 点击启动，让 Agent 开始通过该消息渠道收发消息。

准备用于结果投递的消息渠道会话¶

添加并启动消息渠道，只会完成当前 Agent 与外部机器人账号之间的连接，不会自动创建可用于投递的消息渠道会话。自动化、任务接入等功能实际选择的投递目标，是已为具体群聊或私聊建立的消息渠道会话，而不是消息渠道配置本身。

如需将结果投递到某个群聊或私聊，请先确认消息渠道已启动，然后在目标群聊中添加并 @ 机器人发送一条消息，或向机器人发送一条私聊消息。系统收到消息后，会为该对话创建或复用一个消息渠道会话；返回自动化或任务接入的配置页面，刷新页面或重新打开配置，即可选择该会话。

一个消息渠道可以对应多个消息渠道会话，每个群聊或私聊都是独立的投递目标。选择一个或多个会话后，结果只会发送到所选会话，不会自动广播到同一消息渠道下的其他群聊或私聊。

如果选择列表为空或找不到目标会话，请确认消息渠道已启动，并在目标对话中与机器人完成一次消息交互，再刷新页面或重新打开配置后选择。

不同平台的配置¶

不同 IM 平台的接入方式可能不同，常见配置方式包括：

• 钉钉：通常需要在钉钉开放平台创建企业内部应用，添加机器人能力，并将应用凭证填写到消息渠道配置中。具体步骤可参考 钉钉消息渠道配置；
• 飞书：通常需要创建企业自建应用或机器人，并按页面要求填写应用凭证和事件接收相关配置。具体步骤可参考 飞书消息渠道配置；
• 微信：根据接入方式准备账号、应用信息或扫码授权，完成后再启动消息渠道。

填写凭证时，请确认来源可信，并避免把密钥、Token 或应用凭证发送到群聊、邮件或未授权文档中。

管理已接入消息渠道¶

已接入列表会展示平台、账号、接入方式和运行状态。您可以在列表中启动、停止、重试、查看日志或删除消息渠道。

使用建议¶

• 将消息渠道接入到与 Agent 职责匹配的群聊或账号；
• 为不同职责的 Agent 配置不同消息渠道，避免无关 Agent 进入不需要参与的群聊；
• 自动化任务需要定期汇报结果时，可以将输出推送到固定的消息渠道会话；
• 对涉及生产、客户、安全等内容的消息渠道，限制可使用的 Agent 和成员范围；
• 不要在群聊中发送密钥、Token、安装命令或其他敏感凭证；
• 消息渠道异常时，优先查看运行状态和日志，再决定是否重试或重新授权。