194 lines
6.1 KiB
Markdown
194 lines
6.1 KiB
Markdown
# TSP智能助手 - 快速启动指南
|
||
|
||
## 🚀 一键启动
|
||
|
||
### 方法1: 使用综合管理平台（推荐）
|
||
```bash
|
||
python start_dashboard.py
|
||
```
|
||
访问: http://localhost:5000
|
||
|
||
### 方法2: 使用原有启动方式
|
||
```bash
|
||
python start_web.py
|
||
```
|
||
|
||
## 📋 功能清单
|
||
|
||
### ✅ 已整合的功能
|
||
- [x] **仪表板** - 系统概览和性能监控
|
||
- [x] **智能对话** - 实时聊天和工单创建
|
||
- [x] **Agent管理** - Agent状态和工具管理
|
||
- [x] **预警管理** - 预警监控和规则管理
|
||
- [x] **知识库管理** - 知识检索和添加
|
||
- [x] **工单管理** - 工单创建和状态跟踪
|
||
- [x] **数据分析** - 性能分析和趋势展示
|
||
- [x] **系统设置** - 参数配置和系统信息
|
||
|
||
## 🎯 快速体验
|
||
|
||
### 1. 启动系统
|
||
```bash
|
||
python start_dashboard.py
|
||
```
|
||
|
||
### 2. 访问主页
|
||
打开浏览器访问: http://localhost:5000
|
||
|
||
### 3. 体验功能
|
||
1. **查看仪表板** - 了解系统整体状态
|
||
2. **开始对话** - 测试智能对话功能
|
||
3. **管理预警** - 查看和处理预警
|
||
4. **浏览知识库** - 查看和添加知识
|
||
5. **创建工单** - 测试工单管理功能
|
||
|
||
## 🔧 配置说明
|
||
|
||
### 环境要求
|
||
- Python 3.8+
|
||
- 已安装项目依赖
|
||
- 数据库已初始化
|
||
|
||
### 端口配置
|
||
- 默认端口: 5000
|
||
- 如需修改，编辑 `start_dashboard.py` 中的端口设置
|
||
|
||
### 数据库配置
|
||
- 默认使用SQLite数据库
|
||
- 如需使用MySQL，修改 `src/config/config.py`
|
||
|
||
## 📱 界面预览
|
||
|
||
### 主界面布局
|
||
```
|
||
┌─────────────────────────────────────────────────────────┐
|
||
│ TSP智能助手 - 综合管理平台 │
|
||
├─────────────┬───────────────────────────────────────────┤
|
||
│ 控制面板 │ 主内容区 │
|
||
│ • 仪表板 │ ┌─────────────────────────────────────────┐ │
|
||
│ • 智能对话 │ │ 统计卡片 (活跃会话/预警/工单/知识) │ │
|
||
│ • Agent管理 │ ├─────────────────────────────────────────┤ │
|
||
│ • 预警管理 │ │ 性能趋势图 │ │
|
||
│ • 知识库 │ ├─────────────────────────────────────────┤ │
|
||
│ • 工单管理 │ │ 系统健康状态 │ │
|
||
│ • 数据分析 │ └─────────────────────────────────────────┘ │
|
||
│ • 系统设置 │ │
|
||
└─────────────┴───────────────────────────────────────────┘
|
||
```
|
||
|
||
## 🎨 界面特色
|
||
|
||
### 现代化设计
|
||
- 渐变色彩搭配
|
||
- 圆角卡片设计
|
||
- 动态效果过渡
|
||
- 响应式布局
|
||
|
||
### 直观操作
|
||
- 侧边栏导航
|
||
- 标签页切换
|
||
- 模态框交互
|
||
- 实时状态更新
|
||
|
||
### 数据可视化
|
||
- Chart.js图表
|
||
- 进度条显示
|
||
- 状态指示器
|
||
- 趋势分析
|
||
|
||
## 🔍 功能详解
|
||
|
||
### 仪表板
|
||
- **实时监控**: 系统健康状态、内存使用、CPU使用率
|
||
- **统计概览**: 活跃会话、预警数量、工单状态、知识条目
|
||
- **性能趋势**: 24小时性能变化图表
|
||
- **快速操作**: 一键访问各功能模块
|
||
|
||
### 智能对话
|
||
- **实时聊天**: 基于WebSocket的即时通信
|
||
- **知识库集成**: 自动检索相关知识
|
||
- **工单创建**: 对话中直接创建工单
|
||
- **快速操作**: 预设常用问题
|
||
|
||
### Agent管理
|
||
- **状态监控**: Agent运行状态和活跃目标
|
||
- **工具管理**: 查看工具使用统计和成功率
|
||
- **主动监控**: Agent主动发现和解决问题
|
||
- **执行历史**: 查看Agent执行记录
|
||
|
||
### 预警管理
|
||
- **预警统计**: 按严重程度分类显示
|
||
- **预警列表**: 实时显示活跃预警
|
||
- **预警处理**: 一键解决预警问题
|
||
- **规则管理**: 创建和管理预警规则
|
||
|
||
### 知识库管理
|
||
- **知识检索**: 搜索和浏览知识库
|
||
- **知识添加**: 手动添加新知识
|
||
- **统计分析**: 使用统计和置信度
|
||
- **分类管理**: 按类别组织知识
|
||
|
||
### 工单管理
|
||
- **工单列表**: 查看和管理所有工单
|
||
- **状态过滤**: 按状态和优先级筛选
|
||
- **工单创建**: 创建新的工单
|
||
- **统计分析**: 工单处理统计
|
||
|
||
### 数据分析
|
||
- **性能趋势**: 系统性能变化
|
||
- **类别分布**: 问题类别分布图
|
||
- **详细报告**: 综合分析报告
|
||
- **智能推荐**: 基于分析的改进建议
|
||
|
||
### 系统设置
|
||
- **参数配置**: 调整系统运行参数
|
||
- **模式切换**: 启用/禁用Agent模式
|
||
- **系统信息**: 版本和运行状态
|
||
- **设置保存**: 持久化配置
|
||
|
||
## 🚨 注意事项
|
||
|
||
### 首次使用
|
||
1. 确保已安装所有依赖: `pip install -r requirements.txt`
|
||
2. 初始化数据库: `python init_database.py`
|
||
3. 配置API密钥: 编辑 `src/config/config.py`
|
||
|
||
### 常见问题
|
||
1. **端口被占用**: 修改端口或关闭占用进程
|
||
2. **数据库错误**: 检查数据库连接和权限
|
||
3. **API调用失败**: 检查网络连接和API密钥
|
||
|
||
### 性能建议
|
||
1. **内存使用**: 监控内存使用情况
|
||
2. **数据库优化**: 定期清理历史数据
|
||
3. **缓存策略**: 启用浏览器缓存
|
||
|
||
## 📞 技术支持
|
||
|
||
### 日志查看
|
||
- 应用日志: `logs/dashboard.log`
|
||
- 系统日志: `logs/tsp_assistant.log`
|
||
|
||
### 调试模式
|
||
```bash
|
||
export FLASK_ENV=development
|
||
python start_dashboard.py
|
||
```
|
||
|
||
### 问题反馈
|
||
如遇到问题，请提供：
|
||
1. 错误日志
|
||
2. 操作步骤
|
||
3. 系统环境
|
||
4. 浏览器信息
|
||
|
||
## 🎉 开始使用
|
||
|
||
现在你已经了解了TSP智能助手综合管理平台的所有功能，可以开始体验这个强大的智能客服系统了！
|
||
|
||
```bash
|
||
python start_dashboard.py
|
||
```
|
||
|
||
访问 http://localhost:5000 开始你的智能客服之旅！
|