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

开源地址

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 即可。

效果体验

　　1、关注公众号“盛派网络小助手”

　　2、发送文字“超长”

　　3、关注“盛派网络小助手”小程序

　

　　4、点击“进入客服”，并发送文字“超长”

　　基于 NeuChar 统一架构标准，公众号、小程序、企业微信可以轻松同步实现超长文本的“续航”功能。