🤖 AIOps-Agent

基于多Agent架构的智能运维系统，实现从问题发现 → 分析 → 决策 → 执行的完整闭环。

---

✨ 功能特性

🧠 多Agent协作引擎

• 主控调度Agent - 协调各Agent协作，管理任务流程
• 日志分析Agent - 自动解析日志，提取异常和错误
• 故障定位Agent - 基于AI推理定位根本原因
• 修复方案Agent - 生成可执行的修复命令
• 执行Agent - 安全执行Shell/Docker命令

🔍 核心能力

• 智能日志分析 - 支持粘贴日志或上传文件
• 流式推理输出 - 实时展示Agent思考过程
• 一键命令执行 - 点击即可执行AI生成的命令
• 系统实时监控 - CPU/内存/磁盘资源监控

🎨 可视化界面

• 暗黑科技风格UI
• Agent执行链路可视化
• 实时状态展示
• 历史记录管理

---

🏗️ 系统架构

┌─────────────────────────────────────────────────────────────────────────┐
│                          AIOps-Agent 系统架构                           │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  ┌──────────────────────────────────────────────────────────────────┐   │
│  │                      前端层 (React SPA)                           │   │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐            │   │
│  │  │ 日志输入  │ │ Agent链路 │ │ 结果展示  │ │ 命令执行  │            │   │
│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘            │   │
│  └──────────────────────────┬───────────────────────────────────────┘   │
│                             │ SSE Streaming + HTTP REST               │
│  ┌──────────────────────────┴───────────────────────────────────────┐   │
│  │                    API网关层 (FastAPI)                             │   │
│  │  ┌──────────────────────────────────────────────────────────┐    │   │
│  │  │           /api/analyze  /api/execute  /api/monitor        │    │   │
│  │  └──────────────────────────────────────────────────────────┘    │   │
│  └──────────────────────────┬───────────────────────────────────────┘   │
│                             │                                            │
│  ┌──────────────────────────┴───────────────────────────────────────┐   │
│  │                    多Agent协作引擎                                 │   │
│  │                                                                    │   │
│  │   ┌─────────────┐                                                 │   │
│  │   │ Coordinator │ ← 主控调度，管理任务流程                          │   │
│  │   └──────┬──────┘                                                 │   │
│  │          │ 调度                                                    │   │
│  │   ┌──────┼──────┬──────────┬──────────┐                          │   │
│  │   ▼      ▼      ▼          ▼          ▼                          │   │
│  │ ┌────┐┌────┐┌─────────┐┌────────┐┌──────────┐                  │   │
│  │ │Log ││Root││Solution ││Execute ││ Monitor  │                  │   │
│  │ │Agent││Cause││ Agent  ││ Agent  ││ Agent    │                  │   │
│  │ └────┘└────┘└─────────┘└────────└──────────┘                  │   │
│  │                                                                    │   │
│  │        ┌──────────────────────────────┐                           │   │
│  │        │    DeepSeek API (LLM推理)     │                           │   │
│  │        └──────────────────────────────┘                           │   │
│  └────────────────────────────────────────────────────────────────────┘   │
│                                                                          │
│  ┌──────────────────────────────────────────────────────────────────┐   │
│  │                      基础设施层                                    │   │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐            │   │
│  │  │ Shell执行 │ │ Docker   │ │ 系统监控  │ │ 历史存储  │            │   │
│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘            │   │
│  └──────────────────────────────────────────────────────────────────┘   │
│                                                                          │
└─────────────────────────────────────────────────────────────────────────┘

---

🛠️ 技术栈

后端

技术	版本	用途
Python	3.10+	语言
FastAPI	0.104+	Web框架
Uvicorn	0.24+	ASGI服务器
Pydantic	2.5+	数据验证
psutil	5.9+	系统监控

前端

技术	版本	用途
React	18+	UI框架
Vite	5+	构建工具

AI能力

• DeepSeek API - LLM推理

---

🚀 快速开始

环境要求

• Python 3.10+
• Node.js 18+
• DeepSeek API Key

1. 克隆项目

git clone https://github.com/your-username/AIOps-Agent.git
cd AIOps-Agent

2. 配置环境变量

cp .env.example .env
# 编辑 .env，添加你的 DeepSeek API Key

3. 安装后端依赖

cd backend
pip install -r requirements.txt

4. 安装前端依赖

cd ../frontend
npm install

5. 启动服务

启动后端 (终端1):

cd backend
python main.py
# 运行在 http://localhost:8001

启动前端 (终端2):

cd frontend
npm run dev
# 运行在 http://localhost:3000

6. 访问应用

打开浏览器访问 http://localhost:3000

---

📖 使用说明

智能分析流程

1. 输入日志

   • 在日志输入框粘贴日志内容
   • 或上传日志文件 (.log, .txt, .json)

2. 开始分析

   • 点击「开始智能分析」按钮
   • 观看三个Agent依次执行：
     • 📋 日志分析Agent - 提取错误
     • 🔬 故障定位Agent - 分析根因
     • 💡 修复方案Agent - 生成命令

3. 执行命令

   • 在分析结果中找到修复方案
   • 点击命令旁边的「执行」按钮
   • 查看实时执行结果

系统监控

• 切换到「系统监控」标签页
• 实时查看 CPU/内存/磁盘使用率
• 每3秒自动刷新

历史记录

• 切换到「历史记录」标签页
• 查看之前的分析记录
• 点击可加载历史分析结果

---

📡 API 接口

接口	方法	描述
/api/analyze	POST	SSE流式日志分析
/api/analyze/upload	POST	上传日志文件分析
/api/execute	POST	执行Shell/Docker命令
/api/monitor	GET	获取系统监控数据
/api/history	GET	获取历史记录列表
/api/history/{session_id}	GET/DELETE	获取/删除历史详情
/api/docker/containers	GET	获取Docker容器列表
/api/docker/logs/{name}	GET	获取容器日志
/api/docker/restart/{name}	POST	重启容器

---

🔧 安全特性

• 命令白名单 - 只允许执行预设的安全命令
• 命令黑名单 - 拦截危险命令 (rm -rf /, mkfs 等)
• 执行超时 - 命令执行超时保护 (30秒)
• SSE流式 - 实时输出，无长时间等待

---

🤝 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork 本仓库
2. 创建功能分支: git checkout -b feature/your-feature
3. 提交更改: git commit -m 'Add some feature'
4. 推送到分支: git push origin feature/your-feature
5. 创建 Pull Request

---

📄 许可证

MIT License - 详见 LICENSE 文件

---

📧 联系方式

如有问题或建议，请通过以下方式联系：

• 提交 Issue
• 发送邮件至: 3029956183@qq.com

---

Made with ❤️ for AIOps