前言|微信里冒出一个新 AI 入口,我们把接入它的每一步坑都写下来了
系列《小微(微信小程序 AI)实战》第 0 篇
⚠️ 版本声明:本文基于小微内测版本(截至 2026-11-18 的官方文档与团队实测),微信官方尚未推出正式版本,文中能力、入口、规则均可能随版本迭代调整,正式版发布后请以官方文档为准。
一、这个系列从哪来
2026 年下半年,微信开始在小程序体系里内测一项 AI 能力------「小微」。用户在微信里对小微说一句话,小微理解意图后,直接调用某个小程序注册好的能力,在对话里给出结果卡片,用户点卡片一步进入小程序的具体页面。
我们团队在第一时间把自家小程序(Taro 技术栈)接入了这套能力,完整走过了:
申请开通 → 开发模式选型 → 工程落地 → 写 skill → 自测 → 评测 → 提审 → 发布 → 灰度 → 命中排查与调优
这条链路每一步都有坑。而且这些坑有一个共同的特点:网上搜不到。
- 有的坑是官方文档写得分散、版本更新快,需要交叉核对才能拼出真相;
- 有的坑是内测阶段规则未明,只能靠实测踩出来(比如评测用例的数量硬指标、灰度命中不了的排查路径);
- 有的坑甚至是「文档写的是 A,实际跑起来是 B」------比如文档质量评测对固定话术零容忍、
context.query并不是你想的「抽取后的实体」。
于是我们决定把这些一手经验整理成系列,既给团队内没参与的同学建立完整认知,也给同样在接入路上的开发者一份「踩坑地图」。
二、这个系列讲什么
系列共 11 篇(前言 + 正文 10 篇),按真实接入的时间线展开:
| # | 篇章 | 你将获得 |
|---|---|---|
| 1 | 认识小微 | 小微是什么、入口在哪、一次调用背后的完整链路、两大认知误区 |
| 2 | 接入模式与开通准备 | 自动模式 vs AI 开发模式怎么选,以及不提前确认就会卡死你的版本门槛 |
| 3 | 【实战一】工程化落地 | AI 分包与主工程共存、agent 配置怎么写、配置硬约束 |
| 4 | 【实战二】从零写一个 skill | 用「产品搜索」真实案例讲透 4 个最有普遍价值的实战点 |
| 5 | 【实战三】接力落地 | 用户点完 AI 卡片进来之后:WebView 承载、原子组件跳转、登录收尾 |
| 6 | 【实战四】给 Agent 立人设 | 一份 AGENTS.md 怎么写:身份定位、意图分发表、边界与兜底 |
| 7 | 评测 | 自测与微信团队评测的通过线、用例硬指标、那些预检才会告诉你的坑 |
| 8 | 提审与发布 | 评测通过后到真正上线之间的完整流程与确认清单 |
| 9 | 灰度与命中排查 | 灰度机制、「为什么我命不中」排查决策树、监控看板 |
| 10 | 命中效果调优 | 命中的两层选择模型、代码侧/平台侧的全部调优杠杆 |
一句话概括:从「听说过小微」到「上线并被用户命中」的全链路实战。
三、写给谁看
- 未接触过小微的小程序开发者:本系列的目标读者。不要求你了解任何 AI 相关背景,第 1 篇会从「小微到底是什么」讲起。
- 正在接入的开发者:直接跳到第 3--6 篇看工程落地、skill 编写、接力接收与 Agent 人设,第 7--9 篇的评测、提审与灰度踩坑能帮你省掉大量试错时间。
- 技术决策者:第 1、2 篇足够你判断「要不要接、接哪种模式、成本在哪」。
四、阅读前提与约定
- 内测声明 :小微目前处于内测阶段,系列中所有能力、配置、版本号、评测标准、灰度规则均基于 2026-11 内测版本的官方文档与团队实测,随版本迭代随时可能变更。每篇文首都有版本声明,正式版发布后请以官方文档为准。
- 脱敏:涉及公司名、内部域名、接口地址均已脱敏或使用占位符;所有实测结论均来自团队真实项目,但示例代码做了通用化处理。
- 技术栈背景 :我们的主工程是 Taro + React 的小程序,但小微的 AI 开发模式部分用的是原生小程序代码(官方要求)。系列会讲清楚两者如何共存,不要求你熟悉 Taro。
- 不重复官方文档 :凡是官方文档写清楚的语法细节,我们只给链接不搬运;本系列的价值在于官方没写清、写分散、或者和实际行为不一致的部分。
五、现在开始
如果你对小微还完全没有概念,从第 1 篇开始------它会纠正两个几乎人人都会踩的认知误区,这是后面一切的地基。
👉 下一篇:01 - 认识小微:微信里的 AI 助手到底是什么
本文为实战经验整理(基于内测版本),官方能力与流程以微信开放文档及公众平台后台为准。