## 背景：微信 AI 生态正式向开发者开放

微信公开课近期公布了开发者接入微信 AI 生态的指引。微信开放平台在充分尊重开发者自主选择的基础上，提供了两种接入模式：

- **自动模式**：授权后平台在提审时读取源码，无需额外开发，平台自动分析页面让微信 AI 可直接操作。
- **开发模式**：开发者基于业务特性自主开发 Skill，**通过平台评测与审核后**，才能被微信 AI 调用。

两种模式不互斥，可同时开启。当前处于内测阶段，接入与否不影响现有小程序服务。

这意味着什么？**你自己做的 Skill，可以被微信 AI 直接调用**——这是一个真实的流量入口，面向所有小程序开发者开放。但开发模式有门槛：Skill 必须通过平台评测与审核，才能上线。提前把质量做扎实的开发者，才能在内测开放时第一批跑通。**这篇文章讲的就是评测这一环怎么做。**

---

## 手测 AI Skill，你可能在骗自己

普通功能的测试逻辑很清晰：给定输入，验证输出。但 AI Skill 不一样。

它的输出是非确定性的——同一句话，模型今天理解对了，明天理解偏了。你手动跑了 5 个用例，覆盖的只是你"想到了"的情况。真实用户的表达方式、意图路径、操作序列，远比这复杂。

具体会踩的坑：
- **意图理解偏差**：用户说"帮我查一下"，Skill 理解成了"帮我修改"
- **轨迹跑偏**：意图识别对了，但中间的操作步骤走了弯路，或者遗漏了关键接口调用
- **接口覆盖盲区**：你定义了 10 个原子接口，手测只覆盖了 6 个，剩下 4 个上线后才暴露问题

这些靠人工测不完，也测不准。

---

## wxa-skill-eval 是什么

微信官方提供的小程序 AI Skill 端到端评测工具，开源在 [ai-mode-skills](https://github.com/wechat-miniprogram/ai-mode-skills)。

它做的事情：**自动模拟真实用户对话**，对 Skill 的四个维度进行评估，最终输出一份 `eval_report.html`：

| 维度 | 说明 |
|------|------|
| 意图理解 | Skill 对用户指令的理解准确度 |
| 轨迹生成 | 操作路径的合理性与完整性 |
| 最终答案质量 | 输出结果的正确性 |
| 接口覆盖率 | 原子接口与组件的测试覆盖情况 |

工具本身不内置模型，需要你自己接一个兼容 OpenAI Chat Completions 协议的大模型服务。

---

## 为什么用云开发接，而不是自己配

wxa-skill-eval 需要调用大模型来模拟用户。理论上你可以自己去注册 DeepSeek、Kimi、混元各家账号，分别拿 API Key，切换着用。

但实际上：
- 每家注册流程不一样
- 多个 Key 要分开管理
- 计费和额度要单独盯

云开发的方案更直接：**一个 ENV_ID + 一个 API Key，覆盖所有主流模型。**

云开发兼容 OpenAI Chat Completions 协议，当前 Token 资源包支持的模型包括：混元 hy3-preview、DeepSeek v4 系列、Kimi k2 系列、GLM 5 系列、Qwen 3.5、MiniMax 等。在控制台开启对应模型，配置里换个 MODEL 字段就切换了，其他不动。

---

## 配置 + 跑起来

**第一步：准备工作**

- 开通云开发环境，拿到 ENV_ID
- 购买 Token 资源包
- 控制台 → AI → 生文模型，开启目标模型（推荐 hy3-preview）
- 控制台 → 环境配置 → API Key，创建一个 Key

**第二步：安装**

```bash
cd wxa-skills-eval
pnpm install
```

**第三步：配置 .env**

```
BASE_URL=https://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/cloudbase
API_KEY=<YOUR_CLOUDBASE_API_KEY>
MODEL=hy3-preview
```

把 `<ENV_ID>` 和 `<YOUR_CLOUDBASE_API_KEY>` 换成你的实际值。

**第四步：跑评测**

```bash
# Web UI 模式（推荐，可视化操作）
pnpm dev:web

# 或 CLI 模式
pnpm dev
```

---

## 报告看什么

评测完成生成 `eval_report.html`，四个维度都有评分和明细。

几个关注点：
- **意图理解低**：Skill 的描述或示例用例可能不够清晰，模型理解偏了
- **轨迹得分低**：接口调用顺序或条件判断有问题，需要回头看 Skill 的 action 定义
- **接口覆盖率低**：说明你的测试用例设计不够全，补用例

官方建议每个 Skill 至少跑 **30 个测试用例**，覆盖主流路径 + 边界情况。30 个不是上限，是下限。

> 注意：wxa-skill-eval 是开发阶段自测工具，评测结果不作为微信小程序审核依据，微信官方上线标准另行公布。

---

## 相关链接

- [云开发接入大模型文档](https://docs.cloudbase.net/ai/model/model-access)
- [wxa-skill-eval GitHub 仓库](https://github.com/wechat-miniprogram/ai-mode-skills)
- [微信小程序 AI Skill 评测指南](https://developers.weixin.qq.com/miniprogram/dev/ai/evaluation-guide.html)

微信公开课近期公布了开发者接入微信 AI 生态的指引。微信开放平台在充分尊重开发者自主选择的基础上，提供了两种接入模式：

小程序 AI Skill 上线前，用 wxa-skill-eval + 云开发 CloudBase跑一遍评测

微信 AI 生态正式向开发者开放。开发模式下，你自己做的 Skill 可以被微信 AI 直接调用需要通过平台评测。AI Skill 的质量不像普通功能，靠手测根本覆盖不了。微信官方开源了 wxa-skill-eval，可以在提交审核前自动跑完四个维度的评测，输出可视化报告。接上云开发，一套配置驱动混元、D S、Kimi 等主流模型，不用单独注册各家账号。本文是完整的接入流程，看完可直接操作。

云开发（TCB）团队

人工智能

前端

云计算

微信AI生态开放开发者接入，提供自动模式和开发模式两种选择。开发模式需通过平台评测审核，建议使用官方工具wxa-skill-eval进行AI技能测试，覆盖意图理解、轨迹生成等维度，确保质量。云开发简化大模型接入，支持主流AI服务，助力开发者高效优化小程序AI功能。

GitHub

2026年中大促 | AI 领航 智绘未来

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

小程序 AI Skill 上线前，用 wxa-skill-eval + 云开发 CloudBase跑一遍评测-腾讯云开发者社区-腾讯云

小程序 AI Skill 上线前，用 wxa-skill-eval + 云开发 CloudBase跑一遍评测

小程序 AI Skill 上线前，用 wxa-skill-eval + 云开发 CloudBase跑一遍评测

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐