diff --git a/docs/deploy/platforms/wecom/wecom.md b/docs/deploy/platforms/wecom/wecom.md index adb4f2742..96aa08c2c 100644 --- a/docs/deploy/platforms/wecom/wecom.md +++ b/docs/deploy/platforms/wecom/wecom.md @@ -2,6 +2,12 @@ 部署企业微信机器人接入 LangBot 。 +:::info +- 此配置项是为了实现 LangBot 的群发消息,具体代码位于libs/wecom_api/api.py 。 +- 目前 LangBot 仍在开发,所以未实现此配置项的相关功能。 +- 此配置项可以填写入随机字符,**不能为空**。 +::: + ## 创建机器人 进入[企业微信管理后台](https://work.weixin.qq.com/),登陆账号,进入主页面后,点击` 应用管理 `,` 自建 `,` 创建应用 `,填写机器人基本信息,创建好之后,会出现类似这样的界面: @@ -15,7 +21,7 @@ ![企业ID](/assets/image/wecom2.png) -2. 首先开启通讯录同步权限 +2. 开启通讯录同步权限 ![通讯录权限](/assets/image/wecom5.png) diff --git a/docs/deploy/platforms/wxoa.md b/docs/deploy/platforms/wxoa.md index 1c37ae87d..da1d75516 100644 --- a/docs/deploy/platforms/wxoa.md +++ b/docs/deploy/platforms/wxoa.md @@ -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`,并将消息加解密方式改为`安全模式`。
-至此,将获取到的四个配置项( AppID , AppSecret , token , EncodingAESKey )填入[微信公众号配置项](/deploy/quick-config/config.md#微信公众号适配器)。填写成功后,**启动 LangBot 。**
+至此,将获取到的四个配置项( AppID , AppSecret , token , EncodingAESKey )填入[微信公众号配置项](/deploy/quick-config/config.md#微信公众号适配器)。
+ +在配置项中,`Mode`选项为选择的接入模式,其中默认为`drop`,`drop` 为传统收发消息模式,`passive` 为发送任意文字获取回复模式。
+ +填写成功后,**启动 LangBot 。**
将 URL 填写为`https://your_domain_name/callback/command`,其中的 `your_domain_name` 就是 Caddy 中填写的域名。点击保存。如果可以保存成功,那么意味着部署成功。如果出现**系统发生错误,请稍后重试**,那么请重新检查以上配置内容是否填写正确。 + diff --git a/docs/deploy/quick-config/config.md b/docs/deploy/quick-config/config.md index 99df5948a..6ec865a0b 100644 --- a/docs/deploy/quick-config/config.md +++ b/docs/deploy/quick-config/config.md @@ -165,6 +165,7 @@ "EncodingAESKey":"", "AppSecret":"", "AppID":"", + "Mode":"drop", "host": "0.0.0.0", "port": 2287 } @@ -174,6 +175,8 @@ `enable`:是否启用,配置完成后请将其设为`true` +`Mode`:具体参照微信公众号部署页面 + `host`:运行 微信公众号回调地址 的主机地址,一般不改动 `port`:运行 微信公众号回调地址 的监听端口,一般不改动