使用说明
IM 渠道用于将 Sage AI 接入企业微信、飞书、钉钉等团队即时通讯，员工可在 IM 客户端中直接对话，无需登录 ONE 控制台。机器人绑定配置时所在的账号、环境、资源域，并遵循该范围内的内容安全、命令安全与数据权限。
配置 IM 渠道可将 Sage AI 对话接入团队 IM，实现即时问答与协作。机器人自动绑定当前资源域并遵循权限管控，如需访问全部权限数据，可前往「全部资源域」配置。请勿在不同账号、环境或资源域中重复绑定同一 IM 凭证，否则可能导致消息丢失或对话中断。
先决条件
- 功能菜单：具备 AI 工作台 / 安全运营 / IM 渠道 菜单权限。
- 操作权限：配置、解绑、启停、修改会话超时等需读写权限；只读仅可查看。
- 模型：模型列表中至少有可用推理模型；IM 对话默认按 Auto 路由，不在 IM 内切换模型。
- 网络：
- 长连接（WebSocket / Stream）：平台可出站访问对应 IM 公网即可，无需公网入站（企微、钉钉可用）。
- URL 回调（Webhook / HTTP）：平台需提供公网可访问的 HTTPS 回调地址（企微、飞书、钉钉均可用；飞书本期仅此方式）。
接入方式说明
| 对比项 | 长连接 | URL 回调 |
|---|---|---|
| 原理 | 平台主动连接 IM 官方网关，消息经长连接下发 | IM 主动向平台 HTTPS 地址推送事件 |
| 网络 | 仅需出站 | 需公网域名 + HTTPS 入站 |
| 配置复杂度 | 较低，一般无需回填 URL | 需回填 Webhook |
| 注意 | IM 后台与 AI 工作台必须选同一种方式 | 同左 |
| 渠道 | 支持的连接方式 | 说明文档 |
|---|---|---|
| 企业微信 | 长连接 + URL 回调（两种均支持） | 企业微信对接指南 |
| 飞书 | 仅 URL 回调（配置表单已去掉 WebSocket 长连接；保留应用卡片） | 飞书对接指南 |
| 钉钉 | Stream 长连接 + HTTP URL 回调（两种均支持） | 钉钉对接指南 |
同一账号、环境、资源域下，每种渠道可配置一个机器人；更新配置为覆盖写入。同一 IM 凭证不可跨账号 / 环境 / 资源域重复绑定。
建议先阅读本页，再打开对应渠道指南完成联调。
价值
- 就地协作：在熟悉的 IM 中完成问答、巡检与确认，降低切换控制台成本。
- 权限一致：查询与生成数据均落在绑定账号与资源域内，与 Web 端策略对齐。
- 会话可治理：支持不活跃自动开启新会话；Web 端可只读查看 IM 会话记录。
- 部署灵活：企微 / 钉钉内网可用长连接；飞书及公有云场景使用 URL 回调。
使用场景
运维值班群内提问
在企微 / 飞书 / 钉钉群中 @机器人，查询告警、巡检主机或生成摘要；群内共用一套群会话上下文。
个人私聊排障
与机器人单聊完成诊断；每个 IM 用户私聊为独立会话，与群聊互不串扰。
审批类确认（飞书卡片等）
需人工确认的操作，可在 IM 侧通过对话或应用卡片完成确认（以各渠道能力为准），并记入执行审计。
操作场景
- 配置渠道：选择企微 / 飞书 / 钉钉 ；企微 / 钉钉可选长连接或 URL 回调，飞书仅 URL 回调；填写凭证并保存，回调模式需回填 Webhook。
- 会话管理：设置不活跃自动新会话时长（默认 24 小时，可选 1–24 小时，不可关闭）。
- 解绑：二次确认后解除绑定；解绑后 IM 侧将无法得到 AI 回复。
- 查看 IM 会话：在 Sage AI 历史中切换至 IM 会话（只读）。
开始使用
进入 IM 渠道
登录 Bonree ONE，确认右上角环境与资源域，进入 AI 工作台 → 安全运营 → IM 渠道。
配置某一渠道（总流程）
- 在 IM 开放平台创建机器人 / 应用，并按该渠道指南获取密钥。
- 回到 AI 工作台对应渠道卡片，点击 配置：企微 / 钉钉选择 长连接 或 URL 回调（与 IM 后台一致）；飞书使用 URL 回调。
- 填写字段并 保存；若为 URL 回调，复制 Webhook 回填到 IM 后台。
- 在 IM 中私聊或
@机器人发送「你好」验证连通。
各渠道细节见：
会话管理
| 字段 | 是否必填 | 说明 | 默认值 | 校验规则 |
|---|---|---|---|---|
| 自动开启新会话 | 必填 | 超过设定时间未对话则自动开启新会话 | 24 小时 | 下拉选择 1–24 的整数小时；不可关闭 |
悬停提示：长时间未活跃的历史上下文将不再发送给模型，有效降低 Token 消耗并提升响应速度。
会话按「环境 + 资源域 + 账号 + IM 渠道 + 机器人 + 私聊用户 / 群」隔离。飞书、企微、钉钉会话互不通用。
与 Sage AI（Web）能力差异（摘要）
| 维度 | Sage AI（Web） | IM 渠道 |
|---|---|---|
| 模型选择 | 可切换 | Auto 路由 |
| 智能体 / Skill | 可手动选择 | 意图路由，不手动绑定 |
| 附件 | 支持更完整 | 以文本为主 |
| 富文本展示 | Markdown / 图表等 | 受 IM 格式限制，复杂图可能降级为表或文本 |
| 频率 | 以平台策略为准 | 同一机器人约 1 分钟不超过 20 次提问 |
注意事项
- 请勿在不同账号、环境或资源域重复绑定同一机器人凭证。
- 企微 / 钉钉：接入方式必须两侧一致（同为长连接，或同为 URL 回调）。
- 飞书本期仅 URL 回调，飞书后台请选择「将事件发送至开发者服务器」，不要使用长连接订阅。
- 解绑或密钥不同步会导致 IM 侧无回复。
- IM 触发来源会记入运行概览与审计日志（IM 渠道（企微 / 飞书 / 钉钉））。
- 详细步骤以各渠道对接指南为准。