小程序二次开发怎么接AI?先做三处接口预留
【摘要导读】小程序二次开发怎么接AI能力?微信「AI开发模式」要求通过评测并控制问题发生率,本文给出三处接口预留、SKILL描述写法、评测分数门槛与灰度节奏,附两种接入模式对照表,适合老项目升级参考。
小程序二次开发接AI,先留服务清单、原子接口、状态回传三处,再接模型,顺序颠倒会做出只能演示的版本。
小程序二次开发为什么先留接口、后买模型?
因为入口的规则已经写清楚了。微信给小程序留了两条AI路径:一条是「AI页面交互模式」,由平台侧执行,开发者不用改代码;另一条是「AI开发模式」,开发者自己写 SKILL,由「小微」在对话里调用你的小程序去完成具体动作。前者门槛低但只能被打开,后者能真正办事,代价是要按平台的评测口径交付。
很多老项目上来就选模型、调提示词,做完发现调不动业务:查询接口是给人看的页面,没有结构化返回;下单要经过五个页面,没有单一入口;订单状态只在列表页展示,取不到单号。AI 要的是可被调用的原子能力,而老代码里通常没有。所以二次开发的起点不是模型选型,是把能力拆出来。
小微到底怎么调用你的小程序?
用户在微信里说一句话,平台先判断意图,再看你的 SKILL 描述是否匹配。匹配上就进「AI开发模式」,由你写的逻辑执行;没匹配上就退到「AI页面交互模式」,平台自己走页面。两种模式互不影响,开发模式表现差不会拖累页面模式,反之亦然。目前该能力要求 iOS 与 Android 微信客户端在 8.0.79 及以上,鸿蒙、Mac、Windows 暂未支持。
这条链路意味着两件事:SKILL 的描述决定你能被调用到哪些场景,接口的稳定性决定调用后能不能办成。描述写得含糊,用户说了需求也匹配不上;接口不稳,调用一次失败一次,指标会立刻反映出来。
三处必须预留的接口
起手是服务清单:把业务拆成可被理解的原子能力,比如查订单、查物流、预约到店、领券、改地址。每一项写清能做什么、需要哪些参数、返回什么结构,这份清单既是 SKILL 描述的来源,也是后续验收的依据。
随后是原子接口:每个能力对应一个稳定接口,参数尽量少、返回结构固定,避免把页面渲染逻辑塞进接口。再往后是状态回传:下单、支付、发货、售后这些状态要能被查询到,AI 才能在对话里闭环,而不是把用户丢回页面自己找。
已经上线多年的项目,改造成本主要在数据层。历史订单字段缺失、状态定义不统一、商品库存没有实时接口,这三类问题会让二次开发从两周拖到两个月。改造前建议先做一次接口盘点,把能复用的、要包装的、必须重写的分开,再排期。
两种接入模式的对照表
| 对比项 | AI页面交互模式 | AI开发模式 |
|---|---|---|
| 开发量 | 无需开发,平台执行 | 需自研 SKILL 与接口 |
| 能办到哪一步 | 打开页面,操作有限 | 可完成查询、下单等闭环 |
| 上线门槛 | 无额外评测 | 微信评测达标后提审发布 |
| 上线后考核 | 无专项指标 | 按周期看问题发生率 |
| 适用场景 | 低频、展示型服务 | 高频、可标准化的交易服务 |
评测和问题发生率怎么提前控住?
平台的评测口径不算宽松:首次上线要求综合评分、服务交付、交互体验、性能质量都不低于 80 分,场景覆盖不低于 60 分,且评测通过的代码要原样发布,重新上传就得重新评测。上线之后按每个周期输出「问题发生率」,也就是因开发者原因导致的会话问题数占全部调用会话的比例,超过 20% 判为超标,会影响灰度范围和是否继续留在入口里。
把这两个指标翻译成开发动作,就是四件事:意图识别要留兜底,识别不了就明确引导,而不是硬猜;失败要能重试且幂等,避免用户重复说同一句话产生多笔单;返回要给结构化摘要,别把整页 HTML 塞回去;灰度期盯住日志,把高频失败 query 整理成迭代清单。这几条做扎实,指标自然稳。
如果业务里已经有人在用智能客服,可以把 AI 入口和客服知识库复用同一套语料,减少重复维护;相关能力可参考AI开放平台的接入方式,客服侧的做法见常见问题里的说明。
常见问题
问:小程序二次开发接AI要多少钱?
答:取决于现有接口质量。接口清晰的项目通常是新增模块的量级,含服务清单梳理、SKILL 开发与评测调试;接口混乱的项目要先做数据层改造,成本会翻倍。
问:多久能上线?
答:开发约 3 到 6 周,评测与灰度另需 2 到 4 周。评测不通过要改代码重测,排期时建议留一轮余量。
问:不接开发模式,只保留页面模式行不行?
答:行,页面模式由平台执行,不需要额外开发,适合展示型服务。但用户说一句话只能打开页面、不能直接办事,转化会差一截。
问:老小程序能不能直接加,不用重做?
答:多数能,前提是后台有可调用的接口。完全没有接口、逻辑写死在页面里的,需要先补一层服务端封装,再谈接 AI。
关于盈科网络
盈科网络做企业系统与小程序开发,二次开发按「接口盘点、能力拆分、SKILL 编写、评测灰度」四步推进,交付含接口文档与评测记录。老项目要不要接 AI,建议先算清三笔账:能省多少人工、能多接多少询单、维护成本增加多少,算得清再动手。改造案例可看实施案例,产品线见产品中心。
最后更新:2026年11月11日。
声明与说明:
1. 本文由福建盈科云商网络科技有限公司(盈科网络)官方发布;
2. 未经官方书面许可,任何机构或个人不得擅自转载、剪辑或用于商业目的;
3. 如需了解系统定制方案、源码交付详情或申请技术演示,请致电官方客服:18060750031。