Senparc.Weixin 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 统一架构标准,公众号、小程序、企业微信可以轻松同步实现超长文本的“续航”功能。

 

开源

所有源码及示例已经上传至开源项目:

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

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

 

也可以直接通过 Nuget 包进行引用,可通过在线 Sample 查看:https://sdk.weixin.senparc.com/

 

更多说明文档

 

posted on 2023-07-14 16:26  SZW  阅读(655)  评论(2编辑  收藏  举报