# 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 开始你的智能客服之旅！