Appearance
接入渠道
接入渠道将 Agent 与外部消息平台连接，使 Agent 能够接收和响应来自飞书、钉钉等平台的消息。
核心概念
什么是接入渠道
接入渠道是 Agent 与外部消息入口之间的桥梁。配置完成后，当外部平台收到消息时，Agent 会自动接收并处理。
渠道与 MCP 的区别
| 对比项 | 接入渠道 | MCP 服务 |
|---|---|---|
| 方向 | 外部消息流入 Agent | Agent 主动调用外部工具 |
| 触发方 | 外部用户或系统 | Agent 自身 |
| 用途 | 消息接收与响应 | 工具调用与数据获取 |
| 示例 | 飞书群消息触发 Agent 回复 | Agent 调用数据库查询工具 |
INFO
简单理解：接入渠道负责"消息进来"，MCP 负责"能力出去"。两者配合可以构建完整的自动化响应链路。
支持的平台
- 飞书
- 钉钉
- 微信公众号
- QQ 机器人
渠道通用配置
每个渠道都包含以下基础配置字段：
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| enabled | 开关 | 否 | 是否启用该渠道，默认启用 |
| mode | 下拉选择 | 否 | 运行模式，控制渠道的工作方式 |
| allowCommands | 开关 | 否 | 是否允许通过消息发送命令 |
| defaultTarget | 下拉选择 | 否 | 默认响应目标，指定由哪个 Agent 处理该渠道的消息 |
| allowlistText | 文本 | 否 | 白名单文本，限制哪些用户或群组可以触发 Agent |
各平台配置参数
飞书
进入渠道管理页面，选择「飞书」，填写以下参数：
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| app_id | 文本 | 是 | 飞书应用的 App ID，在飞书开放平台获取 |
| app_secret | 文本 | 是 | 飞书应用的 App Secret（敏感字段，存储后不再明文展示） |
| verification_token | 文本 | 否 | 事件验证 Token，用于验证飞书推送的事件请求合法性 |
| encrypt_key | 文本 | 否 | 事件加密密钥（敏感字段），启用后飞书会加密推送内容 |
| allow_personal_messages | 开关 | 否 | 是否允许处理个人私聊消息 |
| allow_group_messages | 开关 | 否 | 是否允许处理群聊消息 |
| group_reply_mode | 下拉选择 | 否 | 群消息回复模式：mentions_only（仅回复 @机器人 的消息）、all_messages（回复群内所有消息）、except_other_mentions（回复除 @其他人 外的消息） |
钉钉
进入渠道管理页面，选择「钉钉」，填写以下参数：
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| client_id | 文本 | 是 | 钉钉应用的 Client ID，在钉钉开放平台获取 |
| client_secret | 文本 | 是 | 钉钉应用的 Client Secret（敏感字段，存储后不再明文展示） |
| webhook_url | 文本 | 否 | 钉钉机器人的 Webhook 地址，用于主动推送消息 |
微信公众号
进入渠道管理页面，选择「微信公众号」，填写以下参数：
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| app_id | 文本 | 是 | 微信公众号的 AppID，在微信公众平台获取 |
| app_secret | 文本 | 是 | 微信公众号的 AppSecret（敏感字段，存储后不再明文展示） |
| token | 文本 | 是 | 服务器验证 Token，与微信公众平台配置一致 |
| encoding_aes_key | 文本 | 否 | 消息加密密钥（敏感字段），启用安全模式时必填 |
QQ 机器人
进入渠道管理页面，选择「QQ 机器人」，填写以下参数：
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| app_id | 文本 | 是 | QQ 机器人的 AppID，在 QQ 开放平台获取 |
| app_secret | 文本 | 是 | QQ 机器人的 AppSecret（敏感字段，存储后不再明文展示） |
| recipient_type | 下拉选择 | 否 | 接收类型：group（群聊）、user（频道私信）、c2c（单聊） |
配置流程
1. 选择渠道类型
进入接入渠道管理页面，选择要接入的消息平台。
2. 填写平台凭证
按照上方各平台的参数说明，填写 App ID、Secret 等凭证信息。
3. 绑定 Agent
选择负责处理该渠道消息的 Agent。一个渠道绑定一个 Agent，确保消息处理的专注性和一致性。
4. 完成平台授权
按照平台要求完成授权配置。不同平台的授权方式有所不同，请按照页面提示操作。
5. 验证连接
配置完成后，发送一条测试消息确认 Agent 能够正常接收和响应。
WARNING
请确保平台侧的权限配置正确。如果 Agent 无法收到消息，优先检查平台的 Webhook 地址和权限设置。
管理渠道
连接状态
每个渠道会显示当前连接状态。如果连接异常，系统会提示具体原因。
命令日志
命令日志记录了渠道接收到的每条消息及 Agent 的处理情况，便于排查问题和审计操作。
适用场景
| 场景 | 说明 |
|---|---|
| 客服自动回复 | 接入飞书/钉钉群，Agent 自动响应用户问题 |
| 事件通知处理 | 监控系统发送告警消息，Agent 自动执行排查 |
| 审批流程 | 接收审批请求，Agent 按规则自动处理 |
| 信息汇总 | 收集多渠道消息，Agent 定期整理汇总 |
TIP
接入渠道与自动化配合使用效果更佳。通过自动化的通知驱动触发，可以实现更复杂的消息处理逻辑。