↑

微信云开发 AI 模型调用v1.0.0

cloudbase-references-ai-model-wechat2 KB

在微信小程序中通过 wx.cloud.extend.AI 调用混元、DeepSeek 等内置模型，支持文本生成与流式输出，并处理微信小程序特有的 data 包装层、回调监听与原始响应格式差异。适用于开发需要 AI 对话能力的小程序或企业微信应用。

0 0 0 0 更新于 2026-10-28 18:24

免责声明：本站部分 Skill 来源于公开渠道，使用前请注意识别相关风险，内容版权归原作者所有，如 Skill 涉及版权问题，请在线反馈，核实后予以下架处理。

概述

本 Skill 面向微信小程序及企业微信应用开发者，解决在微信特有运行环境（wx.cloud.extend.AI）中调用 AI 模型的实际问题。不同于标准 JS/Node SDK，微信小程序的 streamText 要求参数必须包裹在 data 对象内，generateText 返回的是原始模型响应而非封装后的结构，同时支持 onText、onEvent、onFinish 三种回调实现流式 UI 更新。内置覆盖混元（推荐 hunyuan-2.0-instruct-20251111）与 DeepSeek（推荐 deepseek-v3.2）两大厂商的多款模型，帮助开发者避开平台差异导致的常见集成错误。

技能包含

  • SKILL.md：技能主说明，含触发条件、模型列表、API 差异对照、类型定义与最佳实践

核心能力

  • 微信小程序环境适配：基于 wx.cloud.extend.AI 命名空间，无需额外 SDK，基础库 3.7.1+ 即可使用
  • 文本生成（generateText）：直接调用模型获取完整响应，正确处理原始返回结构（choices / usage）
  • 流式输出（streamText）：支持 data 包装参数、增量文本回调与事件流结束判定（[DONE]）
  • 平台差异对照：明确标注与 JS/Node SDK 在参数传递、返回值结构、回调机制上的关键区别
  • 模型选型指引：提供混元与 DeepSeek 各模型的推荐版本，减少选型成本

应用场景

用户怎么说本技能做什么
"小程序里怎么接入 AI 对话"给出 wx.cloud.extend.AI.createModel 初始化与 generateText 完整调用示例
"流式输出怎么实现逐字显示"提供 streamText 的 onText 回调写法，以及 textStream 异步迭代方案
"为什么 streamText 报错参数不对"指出必须加 data: {...} 包装层，并对比 JS/Node SDK 的差异
"怎么判断流式响应结束了"说明通过 eventStream 监听 event.data === "[DONE]" 的判定逻辑