第三方消息渠道¶

第三方消息渠道（Channel）用于把当前 Agent 接入外部消息平台。接入后，Agent 可以在微信、钉钉、飞书等平台中接收和回复消息。

适用场景¶

第三方消息渠道适合以下协作方式：

• 团队希望在已有群聊中直接提问 Agent；
• 告警、排查或值班场景需要 Agent 参与 IM 协作；
• 用户不想每次都进入控制台，而是希望在消息平台中发起任务；
• 团队需要让 Agent 在固定沟通渠道中沉淀协作过程。

添加消息渠道¶

进入某个 Agent 的工作台，打开 Channel 后，按以下步骤接入：

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

凭证和扫码登录¶

不同平台支持的接入方式可能不同：

• 凭证接入：适合由管理员准备应用信息、密钥或平台凭证；
• 扫码登录：适合需要通过客户端扫码确认的场景。

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

管理已接入消息渠道¶

在已接入列表中，您可以查看：

• 平台；
• 账号；
• 接入方式；
• 运行状态；
• 可执行操作。

常见操作包括：

• 启动：让 Agent 开始通过该消息渠道工作；
• 停止：临时关闭该消息渠道的消息收发；
• 重试：当消息渠道异常时重新尝试启动；
• 查看日志：查看异常原因或排查线索；
• 删除：移除该 Agent 与该消息渠道的连接。

使用建议¶

• 将消息渠道接入到与 Agent 职责匹配的群聊或账号；
• 对涉及生产、客户、安全等内容的消息渠道，限制可使用的 Agent 和成员范围；
• 不要在群聊中发送密钥、Token、安装命令或其他敏感凭证；
• 消息渠道异常时，优先查看运行状态和日志，再决定是否重试或重新授权。