Skip to content

Commit cee725d

Browse files
committed
fix: fix readme
1 parent 54e6ed4 commit cee725d

File tree

2 files changed

+57
-5
lines changed

2 files changed

+57
-5
lines changed

README.md

Lines changed: 56 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -18,36 +18,39 @@ Agent UI 演示效果图
1818
- **企业级功能集成** 流式输出/联网搜索/深度思考/多轮会话 开箱即用
1919
- **多模型支持** 深度兼容 DeepSeek、Hunyuan 等主流大模型
2020
- **配置即开发** 通过配置快速接入组件能力,无需处理复杂通信逻辑
21+
- **支持 MCP Server 调用&自定义工具卡片** 对接云开发MCP Server能力,支持开发者定制工具卡片展示
2122

2223
## 📦 使用指南
2324

24-
### 1. 开通环境
25+
### 组件集成
26+
27+
#### 1. 开通环境
2528

2629
Agent UI 微信小程序组件依赖**微信云开发**服务,需先开通云开发环境
2730

28-
#### 1.1 开通微信云开发
31+
##### 1.1 开通微信云开发
2932

3033
开通方式,点击开发者工具顶部“云开发” 进行开通
3134

3235
![](https://qcloudimg.tencent-cloud.cn/raw/f06ca4761f54ecc8ed8d9644229c92f9.png)
3336

3437
如已开通微信云开发服务,请跳转至[云开发平台](https://tcb.cloud.tencent.com/dev)创建AI服务。
3538

36-
#### 1.2、创建AI服务
39+
##### 1.2、创建AI服务
3740

3841
- 方式一:直接使用agent智能体服务
3942
![](https://qcloudimg.tencent-cloud.cn/raw/97786aaaa15aa1f23e9bbd39a7a6762f.png)
4043
- 方式二:接入大模型
4144
![](https://qcloudimg.tencent-cloud.cn/raw/876d2238b5331a7bdcbd91a1b38b8248.png)
4245

43-
### 2. 获取组件
46+
#### 2. 获取组件
4447

4548
可通过以下两种方式获取组件包代码
4649

4750
1. **克隆仓库到本地,提取其中components/agent-ui 目录使用**
4851
2. **下载GitHub Release 包 agent-ui.zip,直接使用**
4952

50-
### 3. 微信小程序项目引入组件
53+
#### 3. 微信小程序项目引入组件
5154

5255
1. **配置云开发环境ID**
5356
打开 miniprogram/app.js 文件,配置云开发环境ID。
@@ -117,6 +120,54 @@ Page({
117120
})
118121
```
119122

123+
### 自定义 MCP 工具卡片
124+
125+
> 以下示例流程以结合腾讯地图 MCP Server 开发自定义工具卡片举例说明
126+
127+
#### 1. 开通 MCP 能力
128+
129+
- 进入云开发平台 AI+ MCP 页面,点击创建MCP Server
130+
131+
![](https://qcloudimg.tencent-cloud.cn/raw/bc2a7815b542b26f5931aa835514dc37.png)
132+
133+
- 若未开通过云托管服务,需先开通云托管
134+
135+
![](https://qcloudimg.tencent-cloud.cn/raw/084b50f265e0335201801c3fb741d04d.png)
136+
137+
#### 2. 配置 MCP Server
138+
139+
- 以腾讯地图 MCP Server 举例,选择模板进行安装(按照指引获取腾讯地图平台API KEY后,配置环境变量)
140+
141+
![](https://qcloudimg.tencent-cloud.cn/raw/a5b15af9bfff83008257a0c99d252b83.png)
142+
143+
#### 3. agent 绑定 MCP Server tools
144+
145+
- 在 agent 配置页点击添加MCP 服务,选择对应的MCP Server tools 使用 (此处腾讯地图示例可勾选 geocoder,placeSearchNearby, directionDriving, weather等工具)
146+
147+
![](https://qcloudimg.tencent-cloud.cn/raw/b45a95e06ec0df8dab5c9d9ec7707faa.png)
148+
149+
150+
#### 4. 开发自定义卡片组件
151+
152+
- 参照本工程中 apps/miniprogram-agent-ui/miniprogram/components/toolCard 目录内自定义工具卡片组件实现
153+
154+
![](https://qcloudimg.tencent-cloud.cn/raw/14a4a82810f0b45bde0c124cc8f3ed1c.png)
155+
156+
#### 5. 卡片组件引用配置
157+
158+
- 自定义卡片组件引用声明配置(可在用户小程序项目全局app.json中配置 或 agent-ui组件index.json中配置)
159+
160+
![](https://qcloudimg.tencent-cloud.cn/raw/cd1dc376a1e238f3186a2209e5875698.png)
161+
162+
- agent-ui 组件内 customCard/index.wxml 中添加自定义组件
163+
164+
![](https://qcloudimg.tencent-cloud.cn/raw/b4cd35ccaa3e72189934ed59d35f7ae5.png)
165+
166+
#### 6. 卡片效果
167+
168+
<img src="https://qcloudimg.tencent-cloud.cn/raw/82adcd08eec9443f8b8a336342a4fa23.png" width="375px">
169+
170+
120171
## 🏗 项目结构
121172

122173
```bash

apps/miniprogram-agent-ui/miniprogram/components/agent-ui/customCard/index.wxml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,4 +23,5 @@
2323
<view class="customCard" wx:if="{{name === 'placeSearchNearby'}}">
2424
<custom-business-list name="{{name}}" toolData="{{toolData}}"></custom-business-list>
2525
</view>
26+
<!-- 用户可类似添加自定义组件 -->
2627
</block>

0 commit comments

Comments
 (0)