# 运行机制

小程序 AI 开发模式的运行机制涉及宿主客户端运行时、小程序 AI 后台与第三方服务三方的交互,各自的职责如下:

  • 客户端运行时:由宿主客户端提供的独立代码运行环境,用于执行开发者提供的原子接口,并渲染原子组件,为用户展示 GUI 卡片;
  • 小程序 AI 后台:根据开发者封装的 SKILLs,结合用户的请求,发起必要的原子接口调用或原子组件渲染指令;
  • 第三方服务:开发者在原子接口的实现中调用自身服务完成数据交互,并把必要的数据返回给小程序 AI,供其理解及完成用户的请求。

宿主客户端与小程序 AI 后台之间基于小程序 MCP 协议完成交互。开发者无需理解交互协议细节,只需按框架设计提供完整的 SKILL 实现,小程序 AI 就能正确地推理并执行相应的原子接口。

# 运行环境

开发者提供的原子接口与原子组件,运行在宿主客户端创建的一个独立环境中,该环境与小程序的运行环境不同。原子组件相关的逻辑运行在独立的环境上。

# 渲染环境

原子组件使用 WebView 引擎进行渲染,组件框架与小程序自定义组件保持一致的编码方式。

# 生命周期

当用户与小程序 AI 开始对话时,宿主会创建一个新的会话来承载。会话中的聊天记录对用户与小程序 AI 持续可见,直到客户端运行时结束、会话终止;下一次用户重新进入时,会是一个全新的会话。

客户端运行时在以下几种情况下会结束:

  • 小程序 AI 退至后台一段时间后(与小程序后台保活时长一致),客户端会主动结束运行时;
  • 小程序 AI 退至后台后,若系统内存告警,客户端可能会清理运行时;
  • 用户重新启动小程序 AI。

# 交互流程

以一个简化的点单场景为例,交互流程如下:

sequenceDiagram
    participant U as 用户
    participant C as 客户端运行时
    participant A as 小程序 AI 后台
    participant T as 第三方服务

    U->>A: 上行消息:点一杯拿铁,少糖
    A->>A: 加载 SKILL
    A->>C: 下发接口调用:confirmOrder
    C->>C: 启动运行环境,下载分包
    C->>C: 执行原子接口,通过 ft.login 获取用户身份
    C->>T: 创建订单
    T-->>C: 返回订单信息
    C-->>A: 回传执行结果
    A->>C: 下发渲染指令
    C->>U: 渲染原子组件,展示订单
    U->>A: 上行消息:确认支付
    A->>C: 下发接口调用:payOrder
    C->>T: 请求支付参数/创建预支付订单
    T-->>C: 返回支付参数
    C->>U: 拉起支付收银台,用户完成支付
    C->>T: 查询支付状态
    T-->>C: 返回支付结果
    C-->>A: 回传执行结果
    A->>C: 下发渲染指令
    C->>U: 渲染原子组件,展示支付结果

从上述流程可以看出:

  1. 每一次原子接口的调用,都对应一段「模型决策 → 端侧执行 → 结果回流 → 再次推理」的往返;
  2. 原子接口的入参由模型推理产出,返回结果会作为上下文参与下一轮推理;
  3. GUI 卡片的展示由模型下发渲染指令完成,卡片内的用户操作会以新的消息触发下一轮流程。

因此,原子接口的设计粒度会直接影响响应时延与调用效果,具体的优化手段可参考 性能优化建议。

© FinClip with ❤ , Since 2017