Ken19820808/NL2SQLAgent-HF-v2
0
智能數據分析助理
基于 LangChain + FastAPI + React 构建的智能数据分析系统,接入阿里云百炼 Qwen3 模型,实现自然语言查询数据库并实时可视化展示。
项目结构
Lesson02_LLM_API_and_Data_Assistant/
├── backend/ # 后端服务 (FastAPI + LangChain)
│ ├── app/
│ │ ├── main.py # FastAPI 入口
│ │ └── config.py # 配置管理
│ ├── requirements.txt
│ └── README.md
├── frontend/ # 前端应用 (React + TypeScript)
│ ├── src/
│ │ ├── App.tsx # 主应用
│ │ └── main.tsx # 入口
│ ├── package.json
│ └── README.md
└── README.md快速开始
1. 启动后端服务
cd backend
# 创建虚拟环境
python -m venv venv
venv\Scripts\activate # Windows
# source venv/bin/activate # Linux/Mac
# 安装依赖
pip install -r requirements.txt
# 配置环境变量
cp .env.example .env
# 编辑 .env 填入 DASHSCOPE_API_KEY
# 启动服务
uvicorn app.main:app --reload --port 80002. 启动前端应用
cd frontend
# 安装依赖
npm install
# 启动开发服务器
npm run dev3. 访问应用
- 前端: http://localhost:5173
- 后端 API 文档: http://localhost:8000/docs
- 健康检查: http://localhost:8000/health
技术栈
开发阶段
- [x] Phase 1: 搭建前后端基础框架
- [ ] Phase 2: 前端 UI 开发
- [ ] Phase 3: 后端接口开发
- [ ] Phase 4: 前后端联调
License
MIT
