Senparc.Weixin SDK 微信平台开发教程（二十四）：顺应 GenAI 应用，自动“续航”回复超长文本消息

开源地址

GitHub：https://github.com/JeffreySu/WeiXinMPSDK

Gitee：https://gitee.com/JeffreySu/WeiXinMPSDK

概述

　　随着大预言模型应用的进一步流行，以及最大 Token 支持数量的不断上升，自动生成的文本长度也在不断增加。

　　微信作为国内国民级机器对话的最佳选择，成为了许多机器人首选的交互端口。然而，微信出于各方面的考虑，为消息回复的文字容量做了限制（常规为 2048 个字节，经过测试，按照微信的算法大约 680 个汉字左右，半角英文任然可到 2048 个字符）。在我们实际的项目落地过程中，这种限制一定程度上影响了大模型的使用和用户体验，为此，Senparc.Weixin SDK 推出了可自动判断回复文本长度，并全自动判断最合理的消息回复方式（消息接口或客服接口）——“自动续航”功能。

　　由于 Senparc.Weixin SDK 早在很多年前就分离了一整套底层的统一标准架构（NeuChar），本次升级将同时惠及微信公众号、小程序、企业微信及其开放平台的代理接口，并对其行为保持了高度的一致性。基于 NeuChar 标准，您还可以将此能力扩展应用在抖音、头条、QQ、钉钉等不同平台的小程序及公众账号中。

基于 CO2NET 和 NeuChar 标准支持的的全平台统一架构

　　由于 NeuChar 的前瞻性架构，所有包含文字回复的地方都将同时完成升级，包括：公众号、小程序、企业微信。所有的用法和规则均保持高度一致，以下仅以公众号为例介绍。

超长消息处理机制

　　客服消息自动启用超长判断，当回复内容超长时，自动切割成多个消息片段进行发送。

　　消息接口（MessageHandler）默认不启用，启用后整体整体流程如下：

MessageHadler 超长信息处理流程

　　上图中“使用客服接口发送”将自动给超长字符串进行切割，确保每一片都在约定字符数以内，并依次发送。

如何启用

　　对于客服消息，超长判断自动启用，可以通过自定义 limitedBytes 参数修改其默认值（2048 字节是微信约定的最大数）

await Senparc.Weixin.MP.AdvancedAPIs.CustomApi.SendTextAsync("appId", "openId", "消息内容", limitedBytes: 2048);

　　对于消息接口，可以在返回 MessageHandler 结果之前的的任意地方，设置其 TextResponseLimitOptions 属性（包括启动代码中、MessageHandler 构造函数、OnTextRequest 事件方法中、甚至 Controller 中都可以），以下方案可以根据实际情况任选一：

启动代码（中间件）：

app.UseMessageHandlerForMp("/WeixinAsync", CustomMessageHandler.GenerateMessageHandler, options =>
{
    //[必须] 此处为委托，可以根据条件动态判断输入条件
    options.AccountSettingFunc = context => senparcWeixinSetting.Value;

    //[可选] 设置最大文本长度回复限制（超长后会调用客服接口分批次回复）
    options.TextResponseLimitOptions = new TextResponseLimitOptions(2048, senparcWeixinSetting.Value.WeixinAppId);
});

MessageHandler 构造函数

public CustomMessageHandler(Stream inputStream, PostModel postModel, int maxRecordCount = 0, bool onlyAllowEncryptMessage = false, IServiceProvider serviceProvider = null)
    : base(inputStream, postModel, maxRecordCount, onlyAllowEncryptMessage, serviceProvider: serviceProvider)
{
    this.TextResponseLimitOptions = new TextResponseLimitOptions(2048, postModel.AppId);
}

OntextRequest 方法

public override async Task<IResponseMessageBase> OnTextRequestAsync(RequestMessageText requestMessage)
{
    this.TextResponseLimitOptions = new TextResponseLimitOptions(2048, "AppId");
    //...
}

Controller

[HttpPost]
[ActionName("Index")]
public async Task<ActionResult> Post(PostModel postModel)
{
    var messageHandler = new CustomMessageHandler(await Request.GetRequestMemoryStreamAsync(), postModel);
    messageHandler.TextResponseLimitOptions = new TextResponseLimitOptions(2048, "AppId");
    //...
}

　　总之：只需要设置 messageHandler.TextResponseLimitOptions 即可。