灰度与命中排查|代码全对、版本已发,为什么同事就是问不中?
系列《小微(微信小程序 AI)实战》第 9 篇
⚠️ 版本声明:本文基于小微内测版本(截至 2026-11-18 的官方文档与团队实测),微信官方尚未推出正式版本,文中灰度机制、比例、周期、排查标准均可能随版本迭代调整,正式版发布后请以官方文档为准。
写在前面
这是全系列「最痛」的一篇------也是我们真实花掉最多排查时间的一篇。
上线之后的真实场景是这样的:
- 代码全部完成 ✅、评测通过 ✅、版本已发布 ✅
- 你自己手机上命中了,隔壁同事却说「我这边怎么问都不出你们的卡片」
- 又有人命中了,但回答风格不对------像是没走你们的 skill
「命不中」的根因有七八种,个个表现相似、排查路径完全不同。这篇把灰度机制讲清楚,再给一棵按排除成本从低到高排序的排查决策树。
一、先理解灰度的运作方式
1.1 核心认知:发布上线 ≠ 全量可用
内测阶段,AI 能力按灰度方式逐步放量。发布后所有用户并不是立刻可用,而是:
| 规则 | 说明 |
|---|---|
| 起点 L1(10%) | 首次满足上线条件当天,自动进入 L1 |
| 团队默认在内 | 项目成员 + 体验成员默认算在灰度内,不用抢名额 |
| 不支持指定人群 | 灰度不支持指定人组以及范围------想「只给某个同事开灰度」做不到 |
| 周期 3 天 | 一个评估周期 3 天 |
| 达标自动扩量 | 周期内问题率 < 20% → 自动提升灰度范围 |
两个直接推论:
- 「我能命中、同事不能」大概率不是代码问题,是同事不在当前灰度名单/范围里------这是最高频的现象,也是最容易被误判成 bug 的
- 想让某个同事提前体验:先确认他的两个条件(见排查树第 1、2 步),都满足后等平台的灰度周期自然覆盖,或按平台规则走成员管理
1.2 排查第一现场:数据看板
微信官方的 AI 能力调用数据看板:
👉 wedata.weixin.qq.com/mp2/wxa-mon...
灰度期每天看一眼:调用次数、命中分布、失败情况。「到底有没有流量」这个问题,看板比问同事可靠得多------看板显示有调用而你听到的反馈是「没人命中」,大概率是反馈样本太小或版本问题(见排查树)。
二、排查决策树:按成本从低到高
「用户命不中」时,按这个顺序排查,第 1、2 步就能解决 80% 的问题:
markdown
命不中?
│
├─ ① 客户端版本是 iOS/Android 微信 8.0.79+ 吗?
│ └─ 不是(含鸿蒙)→ ✋ 到此为止:mcp+skill 召回能力不可用
│ (没有任何提示,表现得就像「小微不认识你」)
│
├─ ② 该用户在小程序成员管理名单里吗?
│ └─ 不在且不在灰度范围内 → ✋ 等灰度覆盖 / 按规则加成员
│ (内测期:项目成员+体验成员默认在内,其他人跟灰度节奏走)
│
├─ ③ 知识库已发布吗?
│ └─ 草稿态未发布 → 修正知识库发布状态
│ (我们会话里就遇到过:正式环境知识库调用失败,原因是没发布)
│
├─ ④ 用户的话术里提到你的小程序名/服务号了吗?
│ └─ 没有 → 这是「跨小程序选择层」问题,不是 bug
│ (内测期方案:把品牌名写进对话,或配置知识库提高引导概率)
│
├─ ⑤ 命中了吗但表现得像「自主思考」?
│ └─ 判定标准:思考过程有「总结操作完成」/ 卡片上方有「相关服务」
│ = 走的是 AI 页面交互模式,没走你的 mcp
│ → 检查 mcp.json 描述与话术的匹配度(第 10 篇)
│
└─ ⑥ 以上都正常仍不稳定?
└─ 灰度正在阶梯放量中:不同用户处在不同水位是正常现象
周期 3 天、问题率 <20% 自动扩量,给时间
2.1 第 1 步详解:版本是最常见的假故障
mcp + skill 召回仅支持 iOS 和 Android 微信 8.0.79 及以上,鸿蒙暂不支持。版本不满足时:
- 没有报错、没有任何提示
- 小微信照常工作(走平台通用的 AI 能力)
- 表现就是「小微完全不认识你们」
我们的实测:同事反馈「我这边怎么都不行」,排查半天结论是 iOS 微信版本低于 8.0.79------升级微信立刻恢复。
排查第一句话应该是:「你微信什么版本?安卓还是苹果?」而不是「代码是不是有问题」。
2.2 第 2 步详解:灰度名单与成员管理
内测阶段的可用性由两个条件共同决定,缺一不可:
- 客户端版本满足(第 1 步)
- 在灰度范围内(团队项目成员/体验成员默认在;其他用户按平台放量的阶梯覆盖)
「部分人命中、部分人不命中」------如果命中的人都是开发/体验成员,而没命中的人都不是,那这就是灰度机制在工作,不是缺陷。
2.3 第 4 步详解:跨小程序选择层
这是最容易被忽略的机制。回顾系列前文的心智:小微先在平台侧 决定「该调哪个小程序」,再在小程序内 做 skill 路由。第 4 步出问题时,是第一层没选中你:
- 用户只说「帮我看看基金」(没提品牌)→ 平台可能在多个小程序间犹豫,初始阶段容易引导到更知名的产品
- 想让平台更倾向你:对话里带品牌名/小程序名,配合知识库把能力写清楚(第 8 篇)------这也是我们灰度期的实际做法:提示用户提到我们的小程序名再提问
2.4 「自主思考」的判定标准
小微有个重要的兜底行为:未命中任何小程序 mcp 时,会用自己的模型「自主思考」回答(AI 页面交互模式)。它的回答看起来合理,但和你的小程序没有任何关系------这是「命不中」最迷惑人的表现形式。
判定方法(两个标志同时看):
| 标志 | 含义 |
|---|---|
| 思考过程出现「总结操作完成」 | 走的是平台自主思考 |
| 卡片上方出现「相关服务」字眼 | 走的是平台页面理解(自动模式/通用能力) |
两个都没有、直接出了你设计的卡片 → 走的才是你的 mcp + skill。
三、一个真实的排查档案(完整脱敏)
把我们灰度期真实经历的一次完整排查过程记录下来,作为方法论示例:
现象:版本已发布,开发成员命中正常,其他同事全部「命不中」。
排查过程:
- 问版本 → 部分同事微信 8.0.79+,排除版本问题(但那位 8.0.78 的同事就是版本问题,先被分流修好)
- 看成员管理 → 命中的全是项目成员/体验成员,没命中的都不是------判定为灰度未覆盖
- 让其中一位版本达标的非成员同事把品牌名加进提问话术 → 未命中
- 检查知识库 → 发现正式环境知识库未发布(草稿态)------修正
- 修正后该同事命中一次,之后又时好时坏 → 确认是灰度阶梯放量中
结论 :这一次「命不中」其实叠了三个原因(版本 / 灰度 / 知识库),逐个排除才定位干净。排查要有耐心,一次只排除一个变量。
四、给团队的心理预期管理
灰度期的反馈噪音很大,建议提前和团队对齐三点预期(我们内部做过的沟通):
- 「我命不中」≠ 产品质量问题。先问版本和成员身份,别开缺陷单
- 不同人不同状态是正常现象。灰度按阶梯放量,不要横向对比不同账号的命中情况
- 灰度会自动扩量。周期 3 天、问题率 <20%,把关注点放在「命中后的体验质量」------问题率超线会拖慢扩量,那才是真正要修的东西
五、本篇小结
- 灰度机制:L1 10% 起步、团队默认在内、不支持指定人群、周期 3 天、问题率 <20% 自动扩量
- 排查决策树(按成本排序):版本 8.0.79+ → 灰度/成员名单 → 知识库发布 → 话术带小程序名 → 是否自主思考 → 灰度放量中
- 第 1、2 步解决 80% 问题:先说清「版本 + 身份」再谈代码
- 「自主思考」判定:有「总结操作完成」或「相关服务」= 没走你的 mcp
- 数据看板 :
wedata.weixin.qq.com/.../agent/overview,看板比同事反馈可靠 - 一次只排除一个变量:真实案例常常是版本 + 灰度 + 知识库三因叠加
下一篇是系列收官:命中效果调优------命中之后如何让小微更愿意选你、更稳定地选你。
参考
本文为实战经验整理(基于内测版本),官方灰度规则以公众平台后台实际展示为准。