Skip to content

Commit 582b677

Browse files
committed
fix: fix readme
1 parent 5ac312e commit 582b677

File tree

1 file changed

+47
-7
lines changed

1 file changed

+47
-7
lines changed

README.md

Lines changed: 47 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -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

2847
1. **克隆仓库到本地,提取其中components/agent-ui 目录**
2948
2. **下载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
5695
Page({
@@ -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

Comments
 (0)