feat: add docs for wxoa

This commit is contained in:
WangCham
2025-03-13 16:30:54 +08:00
parent 9a9e8e279d
commit 62789798c1
2 changed files with 26 additions and 5 deletions
+6
View File
@@ -2,6 +2,12 @@
部署企业微信机器人接入 LangBot 。
:::info
- 此配置项是为了实现 LangBot 的群发消息,具体代码位于libs/wecom_api/api.py 。
- 目前 LangBot 仍在开发,所以未实现此配置项的相关功能。
- 此配置项可以填写入随机字符,**不能为空**。
:::
## 创建机器人
进入[企业微信管理后台](https://work.weixin.qq.com/),登陆账号,进入主页面后,点击` 应用管理 `,` 自建 `,` 创建应用 `,填写机器人基本信息,创建好之后,会出现类似这样的界面:
+20 -5
View File
@@ -1,10 +1,20 @@
# 部署微信公众号机器人
部署微信公众号机器人接入 LangBot 。
:::warning
- 目前微信公众号对于回复消息的时间有严格限制(不超过15s),所以LangBot在超出响应时间后会将报错打印在控制台上,而不是公众号回复给用户。
- 如果您有更复杂的需求,请联系 LangBot 团队。
:::
## LangBot 微信公众号接入模式
目前,LangBot 提供两种方式接入微信公众号:
1. **传统收发消息模式**
- 公众号要求请求必须在 **15 秒内** 处理完成,超时的 AI 生成内容将无法发送。
- 当 AI 生成内容超时发生后,LangBot 会在控制台打印请求超时信息。
2. **“发送任意文字回复消息”模式**
- 该方法可突破 **15 秒** 限制,但 **过长的文本** 可能无法成功发送。
- 使用此方法时,给公众号发消息,公众号会回复“AI正在思考中,请发送任意内容获取回答”,此时,需要发送任意内容获取回答。
如需更复杂的功能,请联系 **LangBot 团队** 进行定制化支持。
## 创建机器人
@@ -30,7 +40,12 @@
### 保存回调地址
点击设置服务器配置,输入`Token`,`EncodingAESKey`,并将消息加解密方式改为`安全模式`。<br>
至此,将获取到的四个配置项( AppID , AppSecret , token , EncodingAESKey )填入[微信公众号配置项](/deploy/quick-config/config.md#微信公众号适配器)。填写成功后,**启动 LangBot 。**<br>
至此,将获取到的四个配置项( AppID , AppSecret , token , EncodingAESKey )填入[微信公众号配置项](/deploy/quick-config/config.md#微信公众号适配器)。<br>
在配置项中,`Mode`选项为选择的接入模式,其中默认为1,1为传统收发消息模式,2为发送任意文字获取回复模式。<br>
填写成功后,**启动 LangBot 。**<br>
将 URL 填写为`https://your_domain_name/callback/command`,其中的 `your_domain_name` 就是 Caddy 中填写的域名。点击保存。如果可以保存成功,那么意味着部署成功。如果出现**系统发生错误,请稍后重试**,那么请重新检查以上配置内容是否填写正确。