Agent UI 大模型模版

目前云开发的低码组件中，已经提供了可以和 AI 大模型或 Agent 直接对接并使用的 前端组件；可以快速在微搭应用或小程序页面中引入组件并配置对接，即可完成与 大模型 或 Agent 的对接。

下载模版

1. 进入 云开发AI+

2. 选择对应的 应用类型、开发方式、接入类型、AI实例，完成后点击下载模版

3. 解压到任意位置，打开 微信开发者工具 ，点击新建项目

4. 选择到解压的位置，填入对应的AppID，点击创建按钮

5. 点击信任并运行

6. 此时页面会自动编译渲染出来，压缩包中带有依赖，无需构建

7. 修改 app.js 文件中的 env 参数，改为当前云开发环境的环境Id

8. 修改 pages/index/index.js 中的 agentConfig

其中 agentConfig 参数结构如下：

参数名称	参数可选值	说明
chatMode	'bot' 或 'model'	当 chatMode='bot'时，agentConfig.botId 必填；当 chatMode='model'时，modelConfig.modelProvider 和modelConfig.quickResponseModel必填
showBotAvatar	boolean	界面是否展示左侧头像
agentConfig.botId	字符串	agent id，当 chatMode = 'bot' 时，必填
agentConfig.allowUploadFile	boolean	界面是否展示文件上传
agentConfig.allowWebSearch	字符串	允许界面呈现联网配置开关
agentConfig.allowPullRefresh	boolean	允许下拉刷新
agentConfig.allowUploadImage	boolean	允许上传图片
modelConfig.modelProvider	'hunyuan' 或 'deepseek'	大模型服务商
modelConfig.quickResponseModel	字符串	具体的模型版本, 参考大模型版本
envShareConfig.resourceAppid	字符串	环境共享的资源方 AppID
envShareConfig.resourceEnv	字符串	环境共享的资源方环境 ID

文件上传说明

• 大小限制：单文件不超过10M
• 数量限制：单次最多支持 5 个文件
• 文件类型：pdf、txt、doc、docx、ppt、pptx、xls、xlsx、csv
• request合法域名配置：微信小程序上传文件需要添加“文件上传接口”到request合法域名列表，文件上传域名为：https://{envid}.api.tcloudbasegateway.com，替换envid为真实的环境ID， 前往微信公众平台https://mp.weixin.qq.com配置request合法域名

图片上传说明

每次仅支持上传单张图片，最大不超过30MB

示例:

• 使用deepseek-v3模型

{
  chatMode: "model", // bot 表示使用agent，model 表示使用大模型
  showBotAvatar: true, // 是否在对话框左侧显示头像
  modelConfig: {
    modelProvider: "deepseek", // 大模型服务厂商
    quickResponseModel: "deepseek-v3", //大模型名称
    logo: "", // model 头像
    welcomeMsg: "欢迎语", // model 欢迎语
  },
}

• 使用deepseek-r1模型

data: {
  chatMode: "model", // bot 表示使用agent，model 表示使用大模型
  showBotAvatar: true, // 是否在对话框左侧显示头像
  modelConfig: {
    modelProvider: "deepseek", // 大模型服务厂商
    quickResponseModel: "deepseek-r1", //大模型名称
    logo: "", // model 头像
    welcomeMsg: "欢迎语", // model 欢迎语
  },
}

• 使用Agent

{
  chatMode: "bot", // bot 表示使用agent，model 表示使用大模型
  showBotAvatar: true, // 是否在对话框左侧显示头像
  agentConfig: {
    botId: "bot-e7d1e736", // agent id,
    allowWebSearch: true, // 允许客户端选择启用联网搜索
    allowUploadFile: true, // 允许上传文件
    allowPullRefresh: true, // 允许下拉刷新
    allowUploadImage: true // 允许上传图片
  }
}

获取Agent ID

大模型版本

hunyuan

模型版本	说明
hunyuan-lite	具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力

deepseek

模型版本	说明
deepseek-v3	专注于自然语言处理、知识问答、内容创作等通用任务
deepseek-r1	推理模型，专为数学、代码生成和复杂逻辑推理任务设计

相关链接

• Agent UI 区块组件详细参考文档

通过环境共享调用其他环境的AI能力

假设A小程序开通了云开发环境，B小程序想跨环境调用A小程序云开发环境下的AI能力，可参照以下指引。

开通环境共享

登录A小程序，开通环境共享，将A小程序的云开发环境共享给B小程序使用

A小程序和B小程序必须是同一个主体才能环境共享

配置环境共享参数

在B小程序中使用 Agent-UI 时，将A小程序的 appid 和 envId 传给 Agent-UI 组件

参数如下：

  data: {
    chatMode: "model", // bot 表示使用agent，model 表示使用大模型
    showBotAvatar: true, // 是否在对话框左侧显示头像
    modelConfig: {
      modelProvider: "deepseek", // 大模型服务厂商
      quickResponseModel: "deepseek-v3", // 快速响应模型 （混元 turbo, gpt4 turbo版，deepseek v3等）
      logo: "", // model 头像
      welcomeMsg: "欢迎语", // model 欢迎语
    },
    envShareConfig: {
      // 不使用环境共享，请删除此配置或配置EnvShareConfig:null
      // 资源方 AppID
      resourceAppid: "wx7a******5f4f",
      // 资源方环境 ID
      resourceEnv: "chr**************46d2d",
    },
  },