minimap/help.md

思维导图工具使用说明

概述

本工具用于对接腾讯云智能体平台，实现思维导图的可视化展示和交互式对话。

工作流程

腾讯云智能体平台 → 发送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": []
      }
    ]
  }
}

响应

{
  "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格式

{
  "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 文件：

# 腾讯云智能体平台 AppKey
# 获取方式：应用管理 → 找到运行中的应用 → 点击"调用" → 复制AppKey
BOT_APP_KEY=your-app-key-here

# 前端基础URL（用于生成思维导图链接）
FRONTEND_BASE_URL=http://localhost:3000

前端 .env.local 文件：

# 后端API地址
NEXT_PUBLIC_API_BASE_URL=http://127.0.0.1:8000

启动方式

后端

cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

前端

cd frontend
npm install
npm run dev

腾讯云智能体平台配置

在腾讯云智能体平台的系统提示词中，指导AI返回符合上述格式的思维导图JSON。参考 mind_prompt.md 文件中的示例提示词。