概述
云开发 AI 提供统一的大模型接入和 Agent 开发能力，支持在小程序、Web、公众号、企微客服等场景中接入 AI。
控制台功能
左侧导航包含以下模块：
大模型 — 模型总览
生文模型 — 文本生成模型配置
生图模型 — 图片生成模型配置
模型用量 — Token 用量统计
Agent — Agent 列表 / 插入 Agent
Agent 模板 — 预置模板
Agent 数据看板 — 使用数据统计
一、调用大模型
支持多端调用，一套代码适配多模型。
1.1 支持的模型
内置模型
无需额外申请 API Key，使用共享 Token 配额：
模型 | 来源 | Token 来源 |
hunyuan-exp | 云开发 | 共享 Token 配额包 |
deepseek | 云开发 | 共享 Token 配额包 |
自定义模型
支持接入兼容 OpenAI 协议的第三方平台，需配置对应平台的 API Key：
平台 | API 地址 |
DeepSeek 开放平台 | https://api.deepseek.com/v1 |
硅基流动 | https://api.siliconflow.cn/v1 |
智谱 AI 开放平台 | https://open.bigmodel.cn/api/paas/v4 |
火山方舟大模型 | https://ark.cn-beijing.volces.com/api/v3 |
阿里云百炼 | https://dashscope.aliyuncs.com/compatible-mode/v1 |
百度云千帆 | https://qianfan.baidubce.com/v3 |
讯飞星辰 | https://api.xmgfun.com/v1 |
控制台生文模型页面支持：接入自定义模型厂商、查看/配置 Token 用量、查看调用日志。
1.2 核心能力
能力 | 说明 | 支持平台 |
文本生成 | 非流式调用，一次性返回结果 | Web / 小程序 / Node.js |
流式文本生成 | 流式返回，适用于实时对话 | Web / 小程序 / Node.js |
图片生成 | 文生图 | Node.js |
图片理解 | 图生文 | Web / Node.js |
工具调用 | Function Calling | Web / Node.js |
1.3 调用方式
方式 | 适用场景 |
小程序 SDK | 微信小程序 / 小游戏 |
Web SDK | 浏览器端 |
Node SDK | 云函数、云托管、Node.js 服务端 |
cURL / HTTP API | 后端服务、脚本、任意语言 |
OpenAI SDK | 兼容 OpenAI SDK 的项目 |
1.4 快速开始
第一步：获取环境 ID 和 API Key
1. 访问 CloudBase 控制台
2. 进入「环境配置」→「API Key 配置」
3. 创建 API Key（HTTP API）或 Publishable Key（客户端 SDK）
第二步：配置大模型
在 AI 控制台选择模型并填写 API Key（内置模型无需此步）。
第三步：调用
Web 端流式调用示例：
import cloudbase from "@cloudbase/js-sdk";const app = cloudbase.init({env: "<YOUR_ENV_ID>",accessKey: "<YOUR_PUBLISHABLE_KEY>"});const ai = app.ai();const model = ai.createModel("hunyuan-exp");const result = await model.streamText({model: "hunyuan-turbos-latest",messages: [{ role: "user", content: "你好" }],});for await (const text of result.textStream) {console.log(text);}
小程序端非流式调用示例：
wx.cloud.init({ env: "<YOUR_ENV_ID>" });const model = wx.cloud.extend.AI.createModel("hunyuan-exp");const result = await model.generateText({model: "hunyuan-turbos-latest",messages: [{ role: "user", content: "你好" }],});console.log(result.choices[0].message.content);
二、Agent 开发
Agent（智能体）能够自主执行任务、与用户交互并调用外部工具。
2.1 框架选择
框架 | 语言 | 适用场景 |
LangChain | TypeScript / Python | 通用 Agent 开发 |
LangGraph | TypeScript / Python | 复杂多步骤任务 |
CrewAI | Python | 多 Agent 协作 |
2.2 部署方式
方式 | 适用场景 |
HTTP 云函数 | 轻量级 Agent、低频调用，支持 JS / TS / Python |
云托管 | 复杂 Agent、高并发，支持任意语言（容器化） |
2.3 AG-UI 协议
云开发 Agent 兼容 AG-UI 协议，支持 SSE 流式传输、工具调用、人机交互、状态同步。
2.4 开发流程
选择框架 → 开发 Agent → 部署到云开发 → 客户端集成
前置条件：
已开通云开发环境
Node.js 18+ 或 Python 3.9+
已配置大模型（内置 DeepSeek + 混元无需额外申请）
已创建 API Key
安装依赖（LangChain 示例）：
npm install @cloudbase/agent-adapter-langchain @cloudbase/agent-server \\langchain @langchain/openai @langchain/langgraph express
环境变量：
变量名 | 说明 |
TCB_ENV_ID | 云开发环境 ID |
TCB_API_KEY | 云开发 API Key |
TCB_AI_MODEL | 模型名称，默认 hunyuan-turbos-latest |
三、Agent UI 组件
提供开箱即用的聊天界面组件：
组件 | 适用场景 |
小程序源码组件 | 微信小程序原生开发 |
React 组件 | React Web 应用 |
微搭可视化组件 | 微搭低代码平台 |
四、多端发布
五、激励计划
混元 Token 资源包 1 亿
混元生图资源包 1 万张
云开发个人版环境 6 个月
