# 接入企业微信智能机器人

MrDoc 支持将 AI 问答能力接入企业微信智能机器人。配置完成后，企业微信成员可以直接与机器人或在群聊中 @机器人进行知识库问答，无需打开 MrDoc，即可获得基于知识库的 AI 回答。

## 一、配置流程

整个接入流程如下：

1. 在 MrDoc 创建 AI 问答机器人；
2. 获取机器人回调地址；
3. 在企业微信创建智能机器人并填写回调地址；
4. 获取企业微信机器人的密钥信息；
5. 将密钥信息填写回 MrDoc；
6. 启用机器人并开始使用。

流程示意如下：

```text
MrDoc 创建机器人
        │
        ▼
获取回调地址
        │
        ▼
企业微信创建智能机器人
        │
        ▼
填写回调地址
        │
        ▼
生成机器人密钥
        │
        ▼
将密钥填写回 MrDoc
        │
        ▼
配置完成，开始问答
```

---

## 二、在 MrDoc 创建机器人

进入：

> **管理后台 → AI接入 → AI问答机器人**

点击 **新增机器人**。

填写机器人基本信息，例如：

* 机器人名称
* 对应 AI 服务
* 可访问的知识库
* 其他相关配置

![](/media/202607/58a697b2ff434b1596f76ac53534e7549522.png)

保存后，即可创建机器人。

创建成功后，查看和复制该机器人的 **回调地址（Webhook）**。

![](/media/202607/d9bb04f78a8f475d846475e37db3d4988700.png)

> 后续需要将该地址填写到企业微信后台，因此请先复制保存。

---

## 三、企业微信创建智能机器人

在企业微信中搜索应用「智能机器人」。

![](/media/202607/a910b30ec52649d9b8aea8b9ff6e5f558548.png)

进入应用的 **智能机器人** 页面，创建新的机器人。

![](/media/202607/9a58443b569746a6b6637689b54815ff3636.png)

选择「手动创建」：

![](/media/202607/c33137af1c1a4515848137b3f3c41f612331.png)

在机器人创建页面的底部点击「API模式创建」

![](/media/202607/33e7d7c9213741368d66ba71d759e8039035.png)

连接方式选择「使用URL回调」，然后在URL输入框中填入MrDoc中创建的机器人回调地址。

完成后保存配置。

点击「随机获取」按钮生成Token和Encoding-AESKey信息，复制这两个信息。

> 不同版本的企业微信后台显示的字段可能略有区别，请以实际页面为准。

---

## 四、填写到 MrDoc

返回 MrDoc。

进入：

> **AI接入 → AI问答机器人**

编辑刚才创建的机器人。

将企业微信生成的密钥信息分别填写到对应字段：

* Token
* EncodingAESKey

确认无误后保存。

最后回到企业微信机器人的创建页面，点击保存。

---

## 五、开始使用

将机器人添加到需要使用的企业微信群。

群成员可以直接 **@机器人** 提问，例如：

> @MrDoc 如何重置用户密码？

机器人收到消息后，将自动：

1. 接收企业微信消息；
2. 调用 MrDoc AI 问答；
3. 检索已授权的知识库内容；
4. 生成 AI 回答；
5. 将回答发送回企业微信群。

整个过程无需人工参与，实现企业内部知识库的智能问答。

---

## 六、注意事项

* 在接入AI机器人之前，请确保MrDoc的AI知识库功能已启用并配置完成。
* 请确保 MrDoc 服务能够被企业微信访问，公网部署或内网穿透均可，且企业微信配置了其可信域名。
* 修改机器人密钥后，需要同步更新 MrDoc 中对应配置。
* 机器人能够访问的知识内容，由其关联的知识库权限决定，仅会检索已授权的知识库。

配置完成后，即可在企业微信中直接使用 MrDoc AI 问答机器人，实现企业知识库的智能检索与问答。