# AI ops

**Repository Path**: python-cloud/ai-ops

## Basic Information

- **Project Name**: AI ops
- **Description**: AI OPS — 智能运维平台
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-21
- **Last Updated**: 2026-08-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI OPS — 智能运维平台

基于大语言模型的智能 Kubernetes 运维平台。用户通过自然语言（中文/英文）描述运维意图，系统通过**多 Agent 协作架构**理解意图、规划执行步骤、生成 kubectl/SSH 命令，在目标 K8s Master 上执行并返回格式化结果。

## 技术栈

| 层级 | 技术 |
|------|------|
| 后端框架 | FastAPI + Uvicorn |
| 多 Agent 编排 | LangChain + LangGraph (StateGraph) |
| LLM | DeepSeek Chat |
| 数据库 | MySQL 8.0 + SQLAlchemy (async) + Alembic |
| SSH | Paramiko (连接池) |
| 前端 | Vue 3 + Element Plus + Pinia + ECharts |
| 认证 | JWT (access + refresh token) + bcrypt |

## 系统架构

```
Vue 3 Frontend (Port 5173)
       │ HTTP / SSE
FastAPI Backend (Port 8000)
       │ Paramiko SSH
K8s Master Node
       │
DeepSeek API (LangChain)
```

### 多 Agent 协作流程

```
用户意图 → Intent Agent (意图解析) → Supervisor (路由决策)
                                        │
                    ┌───────────────────┼───────────────────┐
                    v                   v                   v
              K8s Agent           Diagnosis Agent     Inspection Agent
              (命令生成执行)        (诊断分析)           (集群巡检)
                    │                   │                   │
                    └───────────────────┼───────────────────┘
                                        v
                              Command Safety Engine (安全检查)
                                        v
                              Result Aggregator (汇总回复)
                                        v
                              SSE 流式返回前端
```

## 功能模块

- **Chat 智能运维** — 意图驱动的自然语言交互，多 Agent 协作过程可视化，SSE 流式输出
- **K8s 资源管理** — Nodes/Pods/Deployments/Services/ConfigMaps/Events 的列表、详情、YAML查看
- **SSH 连接管理** — 连接配置 CRUD，AES-256-GCM 加密存储凭证，连接池管理
- **命令安全引擎** — 三级防护（Block/Confirm/Allow），正则规则匹配，运行时限制
- **仪表盘** — 集群状态总览，CPU/内存使用率，Pod 状态分布
- **审计日志** — 命令执行记录，用户操作追踪
- **RBAC** — admin/operator/viewer 三种角色，资源级权限控制

## 快速开始

### 环境要求

- Python 3.11+
- Node.js 18+
- MySQL 8.0

### 后端

```bash
cd backend
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt

# 复制配置文件并修改实际值
cp .env.example .env

# 数据库迁移
alembic upgrade head

# 启动
uvicorn app.main:app --reload --port 8000
```

### 前端

```bash
cd frontend
npm install
npm run dev
```

访问 http://localhost:5173

### 默认账号

| 角色 | 用户名 | 密码 |
|------|--------|------|
| 管理员 | admin | admin123 |
| 运维 | operator | operator123 |
| 只读 | viewer | viewer123 |

## 项目结构

```
rbac-system/
├── backend/
│   ├── app/
│   │   ├── main.py              # FastAPI 入口
│   │   ├── config.py            # 配置管理
│   │   ├── api/                 # 路由层 (auth, chat, k8s, dashboard, ssh, audit, users)
│   │   ├── models/              # SQLAlchemy ORM 模型
│   │   ├── schemas/             # Pydantic 模型
│   │   ├── services/            # 业务逻辑层
│   │   ├── agent/               # LangGraph 多 Agent (graph, tools, prompts, streaming)
│   │   └── utils/               # 工具函数
│   ├── alembic/                 # 数据库迁移
│   └── requirements.txt
├── frontend/
│   ├── src/
│   │   ├── views/               # 页面组件
│   │   ├── components/          # 可复用组件
│   │   ├── stores/              # Pinia 状态管理
│   │   ├── api/                 # API 请求层
│   │   └── router/              # 路由配置
│   └── package.json
└── README.md
```

## API 文档

启动后端后访问 http://localhost:8000/docs 查看 Swagger UI。