跳到主要内容

IM 机器人

员工不用打开网页,在企业微信、飞书、钉钉里私聊机器人,或在群里 @ 它,就能提问。回答一边生成一边更新,引用了知识库里的图片时,答完会把图一起发出来。

三家都用长连接:KnowWork 主动连到 IM 平台,不需要公网回调地址,也不用开放入站端口,只要服务器能访问外网。

先想清楚:机器人查哪些资料​

机器人不区分提问的人:私聊也好、群里也好,都只查给它选定的那几个知识库。谁能找到这个机器人、能把它拉进群,由 IM 平台的可见范围决定。

所以:

  • 只给机器人选大家都可以看的知识库,比如员工手册、IT 常见问题、公共制度;
  • 需要按个人权限查资料的(比如只有财务能看的库),请员工到 KnowWork 网页里问;
  • 不同的群要查不同的知识库,就建不同的机器人。

在 IM 平台上建机器人​

平台在哪里建要拿到的凭据
企业微信企业微信里新建「智能机器人」,接入方式选 API 模式、连接方式选「使用长连接」,设好可见范围页面上的 Bot ID 与 Secret(点「点击获取」)。注意不是自建应用的 AgentId(1000002 这种纯数字)和应用 Secret
飞书飞书开放平台建企业自建应用,开启机器人能力;事件订阅选「使用长连接接收事件」并订阅「接收消息」;开通读取单聊消息、读取群里 @ 机器人的消息、发送消息与卡片的权限;发布版本应用的 App ID 与 App Secret
钉钉钉钉开放平台建企业内部应用,添加机器人能力,消息接收模式选 Stream 模式;开通互动卡片的写入与流式更新权限,要发图片再开通「企业内机器人发送消息」权限;发布应用的 Client ID(AppKey)与 Client Secret(AppSecret)

在 KnowWork 里添加渠道​

「管理后台」→「渠道」,添加机器人:

  1. 选平台,填上一步拿到的凭据(企业微信还要填机器人名称,就是群里 @ 它时的名字);
  2. 选回答方式:「快速问答」只查知识库作答,回答更快,大多数场景用它就好;
  3. 至少选一个知识库;
  4. 保存。状态变成「已连接」就能用了;连不上时状态栏会写原因。

保存时会建一个和机器人同名的渠道账号,选的知识库自动同步成它的使用权限,在「资源授权」里看得到。机器人的问答都记在这个账号名下,可以在「运行记录」里按它筛选。删除机器人时,这些权限一并收回。

「渠道」里还能看到「谁在问」:哪些人私聊过、哪些群里用过。

员工怎么用​

  • 私聊:直接给机器人发消息;
  • 群聊:只有 @ 机器人的消息才会被处理;
  • 每个人的私聊、每个群各是一个独立的对话,会记住上下文;发「新会话」另起一个对话;
  • 回答逐步更新:企业微信是流式消息,飞书、钉钉是流式卡片;
  • 回答引用了知识库里的图片时,答完把图发出来(最多 10 张)。员工的手机不需要能访问 KnowWork 的地址;
  • 需要人工批准、或者需要追问补充信息的操作,机器人这里做不了,会停下来说明,请员工到网页里继续。

同一个机器人只能配一个渠道。