微信小程序 AI 模型调用
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tencentcloudbase-skills-ai-model-wechat。
技能介绍
小程序里调大模型,错在哪一步
很多团队在小程序里写 wx.cloud.extend.AI.createModel(...) 时,把厂商名或模型 id 填进第一个参数,运行时直接报错或账单对不上。SKILL 明确:createModel(provider) 里合法值只有三组——hunyuan-exp(已开通小程序成长计划)、cloudbase(Token 资源包托管池)、以及以 custom- 开头的自建分组;具体模型写在请求体的 model 字段里。
技能如何约束实现顺序
本技能要求先走固定两步前置,再写业务代码:① 计费资格 → ② 模型组就绪。
- 计费分支:用环境信息判断成长计划是否包含
ai_miniprogram_inspire_plan;未开通时需说明文档入口,而不是静默切到cloudbase。走托管池时要确认pkg_tcb_tokencredits_*资源包有效。 - 组就绪:对目标
GroupName调DescribeAIModels;cloudbase组默认未启用任何模型,需用DescribeManagedAIModelList核对官方模型名,再用UpdateAIModel启用。 - 调用形态:资格与就绪都通过后再
createModel(provider),并支持流式回调;混元与其它托管模型按用户意图走hunyuan-exp或cloudbase决策表。
边界与易错点
不适用浏览器 Web、Node 云函数、小程序内无法提供的文生图,以及没有 CloudBase 小程序 SDK 的运行时——应改用同级技能或 HTTP OpenAPI。引用兄弟技能时用本地相对路径(如 ../auth-tool-cloudbase/SKILL.md),不要远程拉取协议文档进上下文。
使用场景
- 在客服类小程序里接入对话回复,需要先确认成长计划或 Token 包,再启用 `cloudbase` 组里的文本模型
- 产品要在小程序页内做流式问答,按技能顺序完成资格检查与 `DescribeAIModels` 后再写 `createModel`
- 用户指定 DeepSeek 或 Kimi 等托管模型 id,需从 `DescribeManagedAIModelList` 取官方 Model 字符串并 `UpdateAIModel` 启用
- 企业要把自托管 OpenAI 兼容端点接到小程序,需先走 `custom-` 分组注册,而非误用厂商名当 provider
适合人员
- 负责微信小程序 AI 功能、需要把 `wx.cloud.extend.AI` 与 CloudBase 计费路径对齐的前端工程师
- 维护多环境 CloudBase、要在控制台外用 API 批量启用 `cloudbase` 模型组的后端或运维开发
- 接入混元成长计划套餐、需核对 `hunyuan-exp` 默认模型与其它 SKU 是否已启用的产品技术
- 要把第三方兼容 API 注册进小程序环境、避免把 `createModel("deepseek")` 这类写法带进代码库的集成开发