一、控制台功能
左侧导航包含以下模块：
·大模型 — 模型总览
·生文模型 — 文本生成模型配置
·生图模型 — 图片生成模型配置
·模型用量 — 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 应用 |
| 微搭可视化组件 | 微搭低代码平台 |
十三、四、多端发布
| 发布端 | 文档 |
| 小程序 | 发布指南 |
| PC / H5 | 发布指南 |
| 公众号客服 | 接入指南 |
| 小程序客服 | 接入指南 |
| 企微客服 | 接入指南 |
| 服务号客服 | 接入指南 |
十四、五、激励计划
参与 AI 小程序成长计划 可免费获得：
·混元 Token 资源包 1 亿
·混元生图资源包 1 万张
·云开发个人版环境 6 个月