Files
assist/note/快速启动指南.md
2025-09-06 21:06:18 +08:00

6.1 KiB
Raw Blame History

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