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

小程序 AI 开发模式(下文简称"此模式")是 FinClip 提供的一套智能化运行环境与开发框架。基于该框架,开发者可以将小程序的业务功能拆解为原子接口与原子组件,并封装成 SKILL,供小程序 AI 调用。

当用户通过小程序 AI 发起对话时,小程序 AI 会依据小程序 MCP 协议分析用户意图,选择合适的原子接口与原子组件,完成数据处理与任务执行,并将结果整合后回复给用户。

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

# 基本概念

# 1. 小程序 MCP

小程序 MCP 是向小程序 AI 暴露可调用能力的一套协议。与标准 MCP 不同,小程序 MCP 结合小程序开发的特点做了适配:开发者只需按框架设计提供完整的 SKILL 实现,小程序 AI 即可正确地推理并执行相应的原子接口,最终完成用户需求。

# 2. 原子接口

此模式的最小执行单元。它封装单一的业务功能,具有标准化的输入参数与输出结构,运行在宿主客户端创建的独立 JS 环境中,与小程序自身的运行环境相互隔离。

# 3. 原子组件

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

# 4. 页面接力

页面接力是原子接口在小程序内进行可视化展示的一种实现方式:原子接口返回的结构化数据会被传递到小程序页面中展示,使对话流程无缝衔接到小程序页面。

用户发送对话后,小程序 AI 会根据原子接口,输出文本回复或小程序「账号卡片」回复。用户轻触「账号卡片」即可进入对应的接力页面。

# 5. SKILL

SKILL 是完成特定场景任务的完整能力封装。一个小程序可以封装多个 SKILLs,每个 SKILL 包含:

  • 业务说明(SKILL.md)
  • 模型可调用能力的声明(mcp.json)
  • 原子接口与原子组件的实现

# 开发指引

# 接入方式

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

# 运行机制

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

# 最佳实践

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

# 组件与 API 支持

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

© FinClip with ❤ , Since 2017