TuanAnhDoHoang/AI_Incident_Assistant
GitHub: TuanAnhDoHoang/AI_Incident_Assistant
一款面向中小企业的 AI 事件管理助手,通过自动化分流、分类和工单管理,帮助支持团队高效处理群聊中的故障反馈。
Stars: 0 | Forks: 2
# AI_Incident_Assistant
## 🇻🇳 Tiếng Việt
### 简介
**AI Incident Assistant**(演示名称:**AI Incident Copilot**)是一款 AI 助手,旨在帮助中小型企业(尤其是技术支持团队)进行 Bug 接收与 Incident 协调。
该系统作为位于客户群聊与 Issue 管理系统之间的智能层运行,有助于检测 Bug、对 Incident 进行分类、避免 Ticket 重复、跟踪 SLA 并推荐合适的支持人员。
MVP 范围被明确限制为:**仅限文本**、**1 个 Jira 项目** 以及 **P1/P2/P3 三个 Severity 级别**。该系统可以在 **Telegram 群聊或 Web 演示** 上运行,并可以在 Hackathon 中使用 **Mock Jira board**。
### 主要功能
- 从 Telegram 群组或 Web 演示接收消息。
- AI Triage:识别消息是否为 Bug/Incident。
- 提取结构化数据:标题、摘要、模块、Severity、影响范围及建议回复。
- 检测重复的 Incident。
- 在 Mock Jira / Jira 上创建或更新 Ticket。
- 跟踪 SLA 及客户 @ 了人员但未获回复的情况。
- 在团队超载时推荐支持人员。
- 提供 Web Dashboard 以演示整个流程。
### MVP 范围
- 仅处理文本。
- 仅使用 1 个 Jira 项目。
- Severity 仅包含 **P1 / P2 / P3**。
- 不处理图像、音频、附件。
- 不自动修复错误、Rollback 或干预 Production。
### 主要工作流程
1. 客户在群聊中发送 Bug。
2. Bot 存储消息的元数据。
3. AI 对消息进行 Triage 并返回 JSON。
4. 系统检查 Incident 是新的还是重复的。
5. 如果是新的则创建 Ticket,如果是重复的则更新旧 Ticket。
6. 开始跟踪 SLA 并进行回复。
7. 如果团队超载,则推荐合适的人员。
### 推荐的 Bot 命令 / API
- `/bug ` — 报告 Bug
- `/status ` — 查看 Ticket 状态
- `/summary` — 查看 Incident 摘要
- `/suggest ` — 推荐支持人员
### 演示用例
- 从群聊报告新 Bug。
- 检测重复 Bug。
- 客户 @ 了员工但未收到回复。
- 为 Incident 推荐并分配合适的员工。
### 使用 Docker Compose 运行的指南
要求:
- Docker Desktop 正在运行。
- 如果运行数据库 Seed,文件 `team_members_9_nhan_vien_3_nhom.csv` 需位于项目的根目录。
- 无需在本地直接安装 Node.js、React、Vite、Java 或 Maven,因为 Dockerfile 已经配置好了这些环境。
运行整个系统:
```
docker compose up --build
```
在后台运行:
```
docker compose up -d --build
```
仅运行 React/Vite 前端:
```
docker compose up -d --build frontend
```
成功运行后:
- 前端:`http://localhost:3000`
- 后端 API:`http://localhost:8080`
- PostgreSQL:`localhost:5432`
一些有用的命令:
```
docker compose ps
docker compose logs -f frontend
docker compose logs -f app
docker compose down
```
Docker 备注:
- 位于根目录的 `Dockerfile` 使用了 Multi-stage build。
- `frontend` 服务使用 `frontend-dev` 目标来运行 React/Vite。
- `app` 服务使用 `backend` 目标来运行 Java 后端。
## 🇬🇧 English
### 概述
**AI Incident Assistant**(演示名称:**AI Incident Copilot**)是一款专为中小企业和支持团队设计的 AI 驱动的 Incident 管理助手。
它作为客户聊天和 Issue 跟踪系统之间的智能层,帮助团队检测 Bug、对 Incident 进行 Triage、避免 Ticket 重复、监控 SLA 并推荐合适的支持人员。
MVP 范围被有意控制得很小:**仅限文本**、**1 个 Jira 项目** 以及 **Severity 级别 P1/P2/P3**。它可以运行在 **Telegram 群聊或 Web 演示** 上,并可以在 Hackathon 中使用 **Mock Jira board**。
### 主要功能
- 从 Telegram 群聊或 Web 演示进行聊天接收。
- AI Triage:检测消息是否为 Bug/Incident。
- 提取结构化字段:标题、摘要、模块、Severity、受影响范围及建议回复。
- Incident 匹配以检测重复项。
- 在 Mock Jira / Jira 中创建或更新 Ticket。
- SLA 监控及被 @ 后无响应监控。
- 为超载团队提供分派建议。
- 用于展示工作流的 Web 演示 Dashboard。
### MVP 范围
- 仅限文本输入。
- 单个 Jira 项目。
- Severity:**P1 / P2 / P3**。
- 不处理图像、音频或文件附件。
- 无自动修复、Rollback 或 Production 控制。
### 核心工作流
1. 客户在群聊中发送 Bug 消息。
2. Bot 存储消息的元数据。
3. AI 对消息进行 Triage 并生成 JSON 输出。
4. 系统检查 Incident 是新的还是重复的。
5. 创建新 Ticket 或更新现有 Ticket。
6. 启动 SLA 和响应监控。
7. 如果团队超载,Bot 会推荐支持人员。
### API / Bot 命令
- `/bug ` — 报告 Bug
- `/status ` — 查看 Ticket 状态
- `/summary` — 查看 Incident 摘要
- `/suggest ` — 推荐支持人员
### 演示用例
- 从聊天中报告新 Bug。
- 重复 Bug 检测。
- 客户 @ 了员工但未收到回复。
- 为 Incident 推荐并分配合适的人员。
### 使用 Docker Compose 运行
要求:
- Docker Desktop 正在运行。
- 如果希望加载 PostgreSQL Seed 数据,项目根目录中需存在 `team_members_9_nhan_vien_3_nhom.csv` 文件。
- 您不需要在本地安装 Node.js、React、Vite、Java 或 Maven,因为根目录的 Dockerfile 已经提供了这些环境。
运行全栈:
```
docker compose up --build
```
在后台运行:
```
docker compose up -d --build
```
仅运行 React/Vite 前端:
```
docker compose up -d --build frontend
```
启动后:
- 前端:`http://localhost:3000`
- 后端 API:`http://localhost:8080`
- PostgreSQL:`localhost:5432`
有用的命令:
```
docker compose ps
docker compose logs -f frontend
docker compose logs -f app
docker compose down
```
Docker 备注:
- 根目录的 `Dockerfile` 使用了 Multi-stage build。
- `frontend` 服务使用 `frontend-dev` 目标来运行 React/Vite。
- `app` 服务使用 `backend` 目标来运行 Java 后端。
## 许可证
仅供内部 Hackathon 演示 / 教育使用
内部 Hackathon 演示使用
标签:AIOps, AI助手, Bug追踪, DLL 劫持, IT服务管理, Jira集成, JS文件枚举, MVP, SLA监控, Telegram机器人, Web面板, 事件分诊, 事件管理, 云计算, 人工智能, 企业服务, 后端开发, 大语言模型, 安全运营, 工单去重, 工单系统, 扫描框架, 技术支持, 数据提取, 智能分类, 智能运维, 测试用例, 用户模式Hook绕过, 网络研究, 自动化分类, 自动回复建议, 规则引擎, 请求拦截, 运维自动化, 重复事件检测