tsp-assistant/note/快速启动指南.md

TSP智能助手 - 快速启动指南

🚀 一键启动

方法1: 使用综合管理平台（推荐）

python start_dashboard.py

访问: http://localhost:5000

方法2: 使用原有启动方式

python start_web.py

📋 功能清单

✅ 已整合的功能

• 仪表板 - 系统概览和性能监控
• 智能对话 - 实时聊天和工单创建
• Agent管理 - Agent状态和工具管理
• 预警管理 - 预警监控和规则管理
• 知识库管理 - 知识检索和添加
• 工单管理 - 工单创建和状态跟踪
• 数据分析 - 性能分析和趋势展示
• 系统设置 - 参数配置和系统信息

🎯 快速体验

1. 启动系统

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

调试模式

export FLASK_ENV=development
python start_dashboard.py

问题反馈

如遇到问题，请提供：

1. 错误日志
2. 操作步骤
3. 系统环境
4. 浏览器信息

🎉 开始使用

现在你已经了解了TSP智能助手综合管理平台的所有功能，可以开始体验这个强大的智能客服系统了！

python start_dashboard.py

访问 http://localhost:5000 开始你的智能客服之旅！