177 lines
3.6 KiB
Markdown
177 lines
3.6 KiB
Markdown
# 思维导图工具使用说明
|
||
|
||
## 概述
|
||
|
||
本工具用于对接腾讯云智能体平台，实现思维导图的可视化展示和交互式对话。
|
||
|
||
## 工作流程
|
||
|
||
```
|
||
腾讯云智能体平台 → 发送sessionID和思维导图JSON → 本系统存储并返回URL → 用户访问URL查看思维导图 → 点击节点触发AI对话
|
||
```
|
||
|
||
## API 接口
|
||
|
||
### 1. 创建思维导图
|
||
|
||
**请求**
|
||
|
||
```
|
||
POST /api/mindmaps
|
||
Content-Type: application/json
|
||
|
||
{
|
||
"session_id": "腾讯云对话sessionID",
|
||
"mindmap_json": {
|
||
"id": "node_0",
|
||
"label": "机器学习",
|
||
"parent_id": null,
|
||
"level": 0,
|
||
"is_leaf": false,
|
||
"children": [
|
||
{
|
||
"id": "node_1",
|
||
"label": "监督学习",
|
||
"parent_id": "node_0",
|
||
"level": 1,
|
||
"is_leaf": false,
|
||
"children": []
|
||
}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
**响应**
|
||
|
||
```json
|
||
{
|
||
"id": 1,
|
||
"unique_id": "abc123xyz",
|
||
"session_id": "腾讯云对话sessionID",
|
||
"title": "机器学习",
|
||
"raw_json": "{...}",
|
||
"tree": {...},
|
||
"url": "http://localhost:3000/mindmap/abc123xyz",
|
||
"created_at": "2026-03-20T12:00:00",
|
||
"updated_at": "2026-03-20T12:00:00"
|
||
}
|
||
```
|
||
|
||
**说明**
|
||
- `session_id`: 腾讯云智能体平台的对话sessionID，用于后续节点点击时的对话
|
||
- `mindmap_json`: 思维导图的JSON数据，标题从根节点的`label`字段自动提取
|
||
- `url`: 返回的唯一访问链接，可直接发送给用户
|
||
|
||
### 2. 获取思维导图
|
||
|
||
**请求**
|
||
|
||
```
|
||
GET /api/mindmaps/{unique_id}
|
||
```
|
||
|
||
**响应**
|
||
|
||
与创建接口返回格式相同
|
||
|
||
### 3. 对话接口
|
||
|
||
**请求**
|
||
|
||
```
|
||
POST /api/chat
|
||
Content-Type: application/json
|
||
|
||
{
|
||
"session_id": "腾讯云对话sessionID",
|
||
"content": "帮我解释一下监督学习"
|
||
}
|
||
```
|
||
|
||
**响应**
|
||
|
||
SSE流式响应，转发腾讯云智能体平台的对话结果
|
||
|
||
## 思维导图JSON格式
|
||
|
||
```json
|
||
{
|
||
"id": "node_0",
|
||
"label": "根节点标题",
|
||
"parent_id": null,
|
||
"level": 0,
|
||
"is_leaf": false,
|
||
"children": [
|
||
{
|
||
"id": "node_1",
|
||
"label": "子节点标题",
|
||
"parent_id": "node_0",
|
||
"level": 1,
|
||
"is_leaf": true,
|
||
"children": []
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
**字段说明**
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| `id` | string | 节点唯一标识 |
|
||
| `label` | string | 节点显示文本 |
|
||
| `parent_id` | string \| null | 父节点ID，根节点为null |
|
||
| `level` | number | 节点层级，根节点为0 |
|
||
| `is_leaf` | boolean | 是否为叶子节点 |
|
||
| `children` | array | 子节点数组 |
|
||
|
||
## 前端交互
|
||
|
||
1. **查看思维导图**: 用户访问返回的URL即可查看思维导图
|
||
2. **展开/折叠节点**: 点击有子节点的节点可展开或折叠
|
||
3. **触发AI对话**: 点击任意节点，右侧聊天面板会自动显示并发送"帮我解释一下{节点内容}"到腾讯云智能体平台
|
||
4. **继续对话**: 用户可在聊天面板中继续与AI对话
|
||
|
||
## 环境变量配置
|
||
|
||
后端 `.env` 文件：
|
||
|
||
```env
|
||
# 腾讯云智能体平台 AppKey
|
||
# 获取方式：应用管理 → 找到运行中的应用 → 点击"调用" → 复制AppKey
|
||
BOT_APP_KEY=your-app-key-here
|
||
|
||
# 前端基础URL（用于生成思维导图链接）
|
||
FRONTEND_BASE_URL=http://localhost:3000
|
||
```
|
||
|
||
前端 `.env.local` 文件：
|
||
|
||
```env
|
||
# 后端API地址
|
||
NEXT_PUBLIC_API_BASE_URL=http://127.0.0.1:8000
|
||
```
|
||
|
||
## 启动方式
|
||
|
||
### 后端
|
||
|
||
```bash
|
||
cd backend
|
||
pip install -r requirements.txt
|
||
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
|
||
```
|
||
|
||
### 前端
|
||
|
||
```bash
|
||
cd frontend
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
## 腾讯云智能体平台配置
|
||
|
||
在腾讯云智能体平台的系统提示词中，指导AI返回符合上述格式的思维导图JSON。参考 `mind_prompt.md` 文件中的示例提示词。
|