IM 机器人集成

将 AI 助手接入钉钉、飞书、企业微信等 IM 平台

IM 机器人集成

Knodo 支持将 AI 助手接入主流 IM 平台，让团队成员可以在日常使用的即时通讯工具中直接与 AI 助手对话。

核心概念

多助手架构

  • 一个工作空间可发布多个助手：每个助手可以有不同的 System Prompt，适用于不同场景（如产品助手、技术助手、运维助手等）。这种设计适用于将一个空间开放给不同角色用户，通过不同助手控制其可访问的知识范围
  • 一个 IM 机器人可绑定多个助手：同一个钉钉/飞书机器人可以关联多个 AI 助手，用户可按需切换。普通用户无需向 IM 平台管理员申请创建新机器人，即可借助公共机器人通道将自己的助手发布给他人使用
  • 群级默认助手设置：可以为不同群聊设置不同的默认助手，群成员可通过命令 /切换到 <助手名称> 进行设置

助手选择优先级

当用户发送消息时，系统按以下优先级选择助手：

  1. 临时指定 > 群级设置 > 机器人级默认 > 智能引导

支持的平台

平台单聊群聊状态
钉钉✅✅已支持
飞书🚧🚧开发中
企业微信🚧🚧开发中

功能概述

单聊模式

在 IM 平台中与机器人私聊，直接获得 AI 助手的回复：

  • 发送消息后自动获得回复
  • 支持多轮对话，保持上下文
  • 可以切换不同的 AI 助手

群聊模式

在群组中 @机器人 进行对话：

  • @机器人 发送消息触发回复
  • 支持设置群默认 AI 助手
  • 群内成员共享对话上下文

配置步骤

1. 创建 IM 机器人配置

  1. 进入组织设置页面
  2. 点击「IM 机器人」标签
  3. 点击「新建配置」按钮
  4. 选择平台类型（钉钉/飞书/企微）
  5. 填写配置信息
  6. 保存后获取 Webhook URL

2. 在 IM 平台配置机器人

钉钉配置

  1. 登录 钉钉开放平台
  2. 创建企业内部应用
  3. 在「机器人与消息推送」中启用机器人
  4. 配置消息接收地址为 Knodo 提供的 Webhook URL
  5. （可选）配置加签密钥以增强安全性

飞书配置（开发中）

  1. 登录 飞书开放平台
  2. 创建企业自建应用
  3. 添加「机器人」能力
  4. 配置事件订阅地址为 Knodo 提供的 Webhook URL
  5. 填写 App ID 和 App Secret

企业微信配置（开发中）

  1. 登录 企业微信管理后台
  2. 创建应用
  3. 配置接收消息服务器
  4. 填写 Corp ID 和 Agent Secret

3. 绑定 AI 助手

创建 IM 机器人配置后，需要将 AI 助手绑定到该配置：

  1. 进入工作空间设置
  2. 点击「AI 助手」标签
  3. 发布或编辑 AI 助手
  4. 在「IM 机器人绑定」中选择已创建的 IM 机器人配置

4. 设置机器人级默认助手（推荐）

为机器人设置默认助手，新群首次收到消息时将自动使用此助手：

  1. 进入组织设置 → IM 机器人
  2. 点击机器人配置的「设置默认助手」按钮（机器人图标）
  3. 从已绑定的助手中选择一个作为默认
  4. 保存设置

助手选择优先级：群级设置 > 机器人级默认 > 智能引导

使用指南

单聊使用

  1. 在 IM 平台中找到机器人
  2. 发送消息开始对话
  3. 机器人会自动回复

如果绑定了多个 AI 助手，首次对话时会提示选择：

您好！当前有以下 AI 助手可供选择：
1. 产品助手 - 解答产品相关问题
2. 技术助手 - 解答技术相关问题

请回复数字选择助手，或使用 /use <助手名称> 切换。

群聊使用

  1. 将机器人添加到群组
  2. @机器人 发送消息
  3. 机器人会在群内回复

智能首次引导

当机器人首次在新群收到消息时，会根据绑定的助手数量智能处理：

助手数量行为
0 个提示管理员配置助手
1 个自动使用该助手并设为群默认
多个发送选择引导，提示用户选择

临时指定助手

在消息中可以临时指定使用的助手，不会改变群默认设置。支持空格、:、： 作为分隔符：

@机器人 用数据助手 帮我分析这个表格
@机器人 用第1个:这个问题怎么解决
@机器人 用代码助手：请帮我写一个函数

群聊命令

命令说明
/助手列表查看可用的 AI 助手列表
/切换到 <名称>切换群默认 AI 助手
/list查看可用的 AI 助手列表（英文）
/switch <名称>切换群默认 AI 助手（英文）

回复设置

在 IM 机器人配置中可以设置回复行为：

  • 回复时引用原消息：回复时引用用户发送的消息
  • 回复时 @发送者：回复时 @消息发送者

安全配置

加签验证（钉钉）

为增强安全性，建议配置加签密钥：

  1. 在钉钉开放平台获取加签密钥
  2. 在 Knodo 的 IM 机器人配置中填写密钥
  3. 系统会自动验证消息签名

敏感信息保护

  • 所有密钥信息使用 AES-256-GCM 加密存储
  • Webhook URL 包含随机 Token，防止未授权访问
  • 支持随时重新生成 Webhook URL

常见问题

Q：机器人没有回复消息怎么办？

A：请检查以下几点：

  1. Webhook URL 是否正确配置
  2. IM 机器人配置是否已启用
  3. 是否已绑定 AI 助手
  4. 加签密钥是否正确（如果配置了）

Q：如何更换绑定的 AI 助手？

A：进入工作空间设置 → AI 助手 → 编辑助手 → 修改 IM 机器人绑定。

Q：群聊中如何切换 AI 助手？

A：有两种方式：

  1. 临时指定：发送 @机器人 用xxx助手 你的问题，仅本次生效
  2. 切换默认：发送 /切换到 xxx 命令，修改群默认助手

Q：新群没有设置默认助手怎么办？

A：系统会智能处理：

  • 如果机器人只绑定了 1 个助手，会自动使用
  • 如果绑定了多个助手，会发送引导消息让用户选择
  • 建议管理员设置「机器人级默认助手」，新群会自动使用该设置

Q：对话记录会保存吗？

A：是的，所有对话记录都会保存，可以在 Knodo 平台中查看历史对话。

相关文档

IM 机器人集成 | Knodo 文档