# 小程序 AI 开发模式（beta）接入指南

小程序 AI 开发模式（以下简称此模式）提供了一套智能化的运行环境和开发框架，开发者基于该框架，将小程序的功能抽象为原子接口和原子组件，并封装成 SKILL，供小程序 AI 调用。

当用户通过小程序 AI 发起对话时，小程序 AI 会通过小程序 MCP 协议分析并选择合适的原子接口和原子组件，完成数据处理和任务执行，最终整合结果给到用户。

用户在此模式下的登录身份跟原小程序保持一致，开发者可以通过 storage 接口共享小程序内的登录凭证，也可以通过 wx.login、wx.getPhoneNumber 等接口完成登录流程。

当前处于内测阶段，暂未开放小程序 AI 开发模式的代码提审，提审时间将另行通知。请勿将此模式相关代码合入正式版本提交审核，以免影响正常版本发布。

# 基本概念

小程序 MCP 是向小程序 AI 暴露可调用能力的一套协议，与标准 MCP 不同，小程序 MCP 适应于小程序开发的特点，开发者只需要按设计提供完整的 SKILL 实现，小程序 AI 就能正确地推理及执行相应的原子接口，最终完成用户的需求。

此模式的最小执行单元，封装单一的业务功能，具有标准化输入参数和输出结构，运行在微信客户端的独立 JS 环境中。

原子接口的可视化展示单元，将原子接口返回的结构化数据渲染为 GUI 卡片，展示在对话流中。

完成特定场景任务的完整能力封装，一个小程序可封装多个 SKILLs，每个 SKILL 包含：业务说明（SKILL.md）、模型可调用能力的声明（mcp.json）、原子接口与原子组件的实现。

在网页端「微信公众平台 - 基础功能 - AI能力」或小程序「微信开发者助手」中「管理 - 微信AI管理」中的接入模式选择「开发模式」进行申请。

开发者可参考接入方式，将小程序的功能抽象为原子接口和原子组件，并封装成 SKILL，供小程序 AI 调用。

此模式的运行机制涉及微信客户端运行时、小程序 AI 后台、第三方服务之间的交互，其中原子接口、原子组件在微信客户端的执行环境是独立的，不同于小程序运行环境的，具体机制可参考运行机制

开发接入需下载安装微信开发者工具（Nightly Electron Build 最新版本)，具体开发调试过程操作指引请参考调试指南

如何封装好 SKILL，使得小程序 AI 能够准确地识别用户意图，提供更好的用户体验，可参考最佳实践

此模式下提供的接口能力，在用法上，基本与小程序环境下的保持一致。相比于小程序环境下的接口，此模式新增了若干特有 API，以及支持了原有的绝大部分内置组件与 API，具体可参考组件与 API 支持

原子组件会渲染成 GUI 卡片，呈现在对话流上，作为微信原生界面的一部分，为了在设计风格融为一体，可参考设计规范

我们提供一个使用了完整能力的示例 demo，可通过微信开发者工具打开，预览体验。

注意：demo 代码的 appid 需改成在「微信公众平台 - 基础功能 - AI 能力」申请了「开发模式」的 appid