@@ -21,17 +21,56 @@ Agent UI 演示效果图
2121
2222## 📦 使用指南
2323
24- ### 1. 获取组件
24+ ### 1. 开通环境
25+
26+ Agent UI 微信小程序组件依赖** 微信云开发** 服务,需先开通云开发环境
27+
28+ #### 1.1 开通微信云开发
29+
30+ 开通方式,点击开发者工具顶部“云开发” 进行开通
31+
32+ ![ ] ( https://qcloudimg.tencent-cloud.cn/raw/f06ca4761f54ecc8ed8d9644229c92f9.png )
33+
34+ 如已开通微信云开发服务,请跳转至云开发平台(\` https://tcb.cloud.tencent.com/dev\`)创建AI服务。
35+
36+ #### 1.2、创建AI服务
37+
38+ - 方式一:直接使用agent智能体服务
39+ ![ ] ( https://qcloudimg.tencent-cloud.cn/raw/97786aaaa15aa1f23e9bbd39a7a6762f.png )
40+ - 方式二:接入大模型
41+ ![ ] ( https://qcloudimg.tencent-cloud.cn/raw/876d2238b5331a7bdcbd91a1b38b8248.png )
42+
43+ ### 2. 获取组件
2544
2645可通过以下两种方式获取组件代码
2746
28471 . ** 克隆仓库到本地,提取其中components/agent-ui 目录**
29482 . ** 下载GitHub Release 包,直接使用**
3049
31- ### 2 . 引入组件
50+ ### 3 . 引入组件
3251
33- 1 . ** 拷贝源码组件,将 agent-ui 组件放入用户项目 components 目录中**
34- 2 . ** 组件所属页面 .json配置文件中注册组件**
52+ 1 . ** 配置云开发环境ID**
53+ 打开 miniprogram/app.js 文件,配置云开发环境ID。
54+
55+ ``` js
56+ App ({
57+ onLaunch : function () {
58+ if (! wx .cloud ) {
59+ console .error (" 请使用 2.2.3 或以上的基础库以使用云能力" );
60+ } else {
61+ wx .cloud .init ({
62+ env: " " ,// 环境id
63+ traceUser: true ,
64+ });
65+ }
66+
67+ this .globalData = {};
68+ },
69+ });
70+ ```
71+
72+ 2 . ** 拷贝源码组件,将 agent-ui 组件放入用户项目 components 目录中**
73+ 3 . ** 组件所属页面 .json配置文件中注册组件**
3574
3675``` json
3776{
@@ -42,15 +81,15 @@ Agent UI 演示效果图
4281
4382```
4483
45- 3 . ** 组件所属页面 .wxml 文件中引用组件**
84+ 4 . ** 组件所属页面 .wxml 文件中引用组件**
4685
4786``` wxml
4887<view>
4988 <agent-ui agentConfig="{{agentConfig}}"></agent-ui>
5089</view>
5190```
5291
53- 4 . ** 组件所属页面 .js 文件中编写配置**
92+ 5 . ** 组件所属页面 .js 文件中编写配置**
5493
5594``` js
5695Page ({
@@ -96,7 +135,7 @@ Page({
96135| ------------------ | ---------- | ---- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
97136| ` type ` | ` String ` | 是 | 全局生效 | 对话模式:` bot ` - 使用Agent ` model ` - 直连大模型 |
98137| ` botId ` | ` String ` | 条件 | ` type=bot ` | 配置Agent的唯一标识符(需先在[ 腾讯云开发平台上创建Agent] ( https://docs.cloudbase.net/ai/agent/ ) ) |
99- | ` modelName ` | ` String ` | 条件 | ` type=model ` | 大模型服务商标识 :` deepseek ` /` hunyuan-open ` |
138+ | ` modelName ` | ` String ` | 条件 | ` type=model ` | 大模型服务标识 :` deepseek ` /` hunyuan-open ` |
100139| ` model ` | ` String ` | 条件 | ` type=model ` | 模型版本标识:modelName 为 deepseek时,支持 deepseek-r1/deepseek-v3; modelName为 hunyuan-exp (混元体验版)/ hunyuan-open(混元正式版,使用需先[ 配置API Key] ( https://tcb.cloud.tencent.com/dev?envId=luke-agent-dev-7g1nc8tqc2ab76af#/ai?tab=ai-model&model=hunyuan-open ) )时,model可配置为hunyuan-lite |
101140| ` logo ` | ` String ` | 否 | ` type=model ` | 自定义LOGO URL |
102141| ` welcomeMessage ` | ` String ` | 否 | ` type=model ` | |
@@ -204,6 +243,7 @@ Page({
204243- ✅ 联网搜索 (Agent模式)
205244
206245### 🚧 进行中开发
246+
207247- 多模型切换调用配置化
208248- 多Agent切换调用配置化
209249- 历史会话管理,多轮对话上下文记忆
0 commit comments