Mini Program AI Development Mode (beta) Integration Guide | WeChat Open Documentation

Source: https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html Mini Program AI Development Mode (hereinafter referred to as this mode) provides an intelligent runtime environment and development framework. Based on this framework, developers abstract the functions of a mini program into atomic interfaces and atomic components, and encapsulate them into SKILLs for the Mini Program AI to invoke.

When a user initiates a conversation through the Mini Program AI, the Mini Program AI analyzes and selects appropriate atomic interfaces and atomic components via the Mini Program MCP protocol, completes data processing and task execution, and finally integrates the results for the user.

In this mode, user login identity remains consistent with the original mini program. Developers can share login credentials within the mini program via the storage interface, or use wx.login, wx.getPhoneNumber, and other interfaces to complete the login flow.

This mode is currently in beta testing. Code submission for Mini Program AI Development Mode is not yet open. The submission date will be announced separately. Do not merge any code related to this mode into the official version for review, to avoid affecting normal version releases.

# (https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html#%E5%9F%BA%E6%9C%AC%E6%A6%82%E5%BF%B5)Basic Concepts

# (https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html#_1%E3%80%81%E5%B0%8F%E7%A8%8B%E5%BA%8F-MCP)1. Mini Program MCP

The Mini Program MCP is a protocol that exposes callable capabilities to the Mini Program AI. Unlike standard MCP, the Mini Program MCP adapts to the characteristics of mini program development. Developers only need to provide a complete SKILL implementation according to the design, and the Mini Program AI can correctly reason and execute the corresponding atomic interfaces to fulfill user requests.

# (https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html#_2%E3%80%81%E5%8E%9F%E5%AD%90%E6%8E%A5%E5%8F%A3)2. Atomic Interface

The smallest execution unit in this mode, encapsulating a single business function with standardized input parameters and output structure, running in an independent JS environment of the WeChat client.

# (https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html#_3%E3%80%81%E5%8E%9F%E5%AD%90%E7%BB%84%E4%BB%B6)3. Atomic Component

The visual display unit of an atomic interface. It renders the structured data returned by the atomic interface as a GUI card, displayed in the conversation flow.

# (https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html#_4%E3%80%81SKILL)4. SKILL

A complete capability encapsulation for completing tasks in specific scenarios. A mini program can encapsulate multiple SKILLs. Each SKILL includes: a business description (SKILL.md), a declaration of model-callable capabilities (mcp.json), and the implementation of atomic interfaces and atomic components.

# (https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html#%E5%BC%80%E5%8F%91%E6%8C%87%E5%8D%97)Development Guide

# (https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html#%E7%94%B3%E8%AF%B7%E5%BC%80%E5%90%AF)Apply for Activation

On the web version of “WeChat Official Platform - Basic Functions - AI Capabilities” or in the mini program “WeChat Developer Assistant” under “Management - WeChat AI Management”, select “Development Mode” as the access mode to apply.

# (https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html#%E6%8E%A5%E5%85%A5%E6%96%B9%E5%BC%8F)Integration Method

Developers can refer to the Integration Method (https://developers.weixin.qq.com/miniprogram/dev/ai/integration) to abstract mini program functions into atomic interfaces and atomic components, and encapsulate them into SKILLs for the Mini Program AI to invoke.

# (https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html#%E8%BF%90%E8%A1%8C%E6%9C%BA%E5%88%B6)Operating Mechanism

The operating mechanism of this mode involves interactions among the WeChat client runtime, the Mini Program AI backend, and third-party services. The execution environment for atomic interfaces and atomic components in the WeChat client is independent of the mini program runtime environment. For details, see the Operating Mechanism (https://developers.weixin.qq.com/miniprogram/dev/ai/operating-mechanism).

# (https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html#%E8%B0%83%E8%AF%95%E6%8C%87%E5%8D%97)Debugging Guide

For development integration, you need to download and install the WeChat Developer Tool (Nightly Electron Build, latest version) (https://developers.weixin.qq.com/miniprogram/dev/devtools/log#nightly). For specific development and debugging instructions, see the Debugging Guide (https://developers.weixin.qq.com/miniprogram/dev/ai/debugging).

# (https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html#%E6%9C%80%E4%BD%B3%E5%AE%9E%E8%B7%B5)Best Practices

For guidance on how to properly encapsulate SKILLs so that the Mini Program AI can accurately recognize user intents and provide a better user experience, see Best Practices (https://developers.weixin.qq.com/miniprogram/dev/ai/best-practices).

# (https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html#%E7%BB%84%E4%BB%B6%E4%B8%8E-API-%E6%94%AF%E6%8C%81)Component and API Support

The interface capabilities provided in this mode are largely consistent in usage with those in the mini program environment. Compared to the mini program environment, this mode adds several unique APIs and supports most of the original built-in components and APIs. For details, see Component and API Support (https://developers.weixin.qq.com/miniprogram/dev/ai/reference/component).

# (https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html#%E8%AE%BE%E8%AE%A1%E8%A7%84%E8%8C%83)Design Guidelines

Atomic components are rendered as GUI cards in the conversation flow, as part of WeChat’s native interface. To maintain a unified design style, see Design Guidelines (https://developers.weixin.qq.com/miniprogram/dev/ai/design-guild).

# (https://developers.weixin.qq.com/miniprogram/dev/ai/guide.html#%E7%A4%BA%E4%BE%8B-Demo)Example Demo

We provide an example demo (https://github.com/wechat-miniprogram/ai-mode-demo) that demonstrates the complete capabilities. You can open it with the WeChat Developer Tool to preview and experience it.

Note: The appid in the demo code must be replaced with an appid that has applied for “Development Mode” in “WeChat Official Platform - Basic Functions - AI Capabilities”.