uni-app x

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

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

uni-app vue2 项目 从 5.14+ 支持此模式，uni-app x 和 uni-app vue3 项目 从 5.21+ 支持此模式。

# 开发指南

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

申请结束之后，开发者需要下载最新 nightly 版本的微信小程序开发者工具，下载地址

# 接入方式

小程序 AI 开发模式提供了一套智能化的运行环境和开发框架，开发者可根据自身业务要求，将小程序的功能抽象为原子接口和原子组件，并封装成 SKILL，供小程序 AI 调用。

开发者需要在 manifest.json 中配置 mp-weixin 的相关信息，例如：

// manifest.json
{
  "mp-weixin": {
    "appid": "your appid",
    "lazyCodeLoading": "requiredComponents",
    "agent": {
      "instruction": "AGENTS.md",
      "pageMetadata": "page-meta.json",
      "skills": [
        {
          "name": "learn-ai-interaction",
          "description": "用卡片和模拟业务接口讲解微信小程序与小程序 AI 的交互方式",
          "path": "ai-packages/learn/ai-interaction-skill"
        }
      ]
    }
  }
}

示例源码如下，请查看 pre > code 标签中的内容

// manifest.json
{
  "mp-weixin": {
    "appid": "your appid",
    "lazyCodeLoading": "requiredComponents",
    "agent": {
      "instruction": "AGENTS.md",
      "pageMetadata": "page-meta.json",
      "skills": [
        {
          "name": "learn-ai-interaction",
          "description": "用卡片和模拟业务接口讲解微信小程序与小程序 AI 的交互方式",
          "path": "ai-packages/learn/ai-interaction-skill"
        }
      ]
    }
  }
}

编译的时候会自动拷贝 instruction、pageMetadata、skills 等文件到产物目录下。

详细的接入方式和使用方法，请参考小程序 AI 开发模式接入方式

# 注意事项

instruction、pageMetadata、skills 等文件的位置是相对于 manifest.json 的路径。比如 cli 项目中 manifest.json 通常位于 src 目录，按上面的配置，AGENTS.md、page-meta.json 以及 ai-packages/learn/ai-interaction-skill 都需要放在 src 目录下，例如：

src
├─manifest.json
├─AGENTS.md
├─page-meta.json
└─ai-packages
  └─learn
    └─ai-interaction-skill
      ├─mcp.json
      ├─index.js
      ├─SKILL.md
      ├─components
      └─...

示例源码如下，请查看 pre > code 标签中的内容

src
├─manifest.json
├─AGENTS.md
├─page-meta.json
└─ai-packages
  └─learn
    └─ai-interaction-skill
      ├─mcp.json
      ├─index.js
      ├─SKILL.md
      ├─components
      └─...