AIOpsLab

给运维智能体搭个可复现的故障演练场,直接比出谁更能修。

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 智能体 🍴 复刻 183 🐛 待处理 40 👀 关注 17
GitHub ↗
GitHub 星标 ★ 1036
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,无在线服务

项目预览

AIOpsLab 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类智能体
开发团队microsoft
定价模式🏷️完全免费
价格说明开源免费,无在线服务
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
GitHub 星标★ 1036
上线时间2024-10-11 00:00:00
代码更新2026-11-14
仓库体积34.1 MB
本站数据更新2026-11-22
维护状态较活跃
收录时间2026-10-08
浏览次数4

项目介绍

AIOpsLab 是微软开源的面向自主 AIOps 智能体的整体框架,目标是让运维智能体的设计、开发与评测形成闭环。它解决的核心问题是:现有 AIOps 研究多聚焦单点算法,缺乏统一环境来复现故障、注入异常并量化智能体的诊断与修复效果。框架提供可插拔的智能体接口、模拟微服务与云环境的故障注入、以及标准化的评测指标,让开发者能像跑基准测试一样比较不同智能体在检测、定位、根因分析和自动修复上的表现。核心能力包括:环境编排与故障场景生成、智能体工具调用与观测接口、多维度评估流水线,以及可扩展的插件体系。它适合把 LLM 智能体、强化学习策略或传统运维算法放进同一套可复现的沙箱中验证,降低从论文到落地的门槛。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 1036

使用教程

难度:高级 约 20 分钟 部署方式:本地安装 8 步

环境要求

  • Python >= 3.11
  • Helm(用于部署微服务云环境)
  • Poetry(推荐)或 pip
  • 一个可用的 Kubernetes 集群,本机 kubectl context 已指向该集群(远程集群需配 Ansible,另见 scripts/ansible/
  • 运行远程服务时需可访问的宿主机与端口

安装与启动步骤

  1. 1安装 Python 3.11

    在 Linux 上用 apt 安装 Python 3.11 及其 venv、dev 组件,AIOpsLab 要求 Python 版本不低于 3.11。

    sudo apt update
    sudo apt install python3.11 python3.11-venv python3.11-dev -y
  2. 2安装 Poetry

    使用官方安装脚本,不要用 apt 版本(已过时);安装后把 Poetry 的 bin 目录加入 PATH。

    curl -sSL https://install.python-poetry.org | python3.11 -
    export PATH="$HOME/.local/bin:$PATH"
  3. 3克隆仓库

    必须带 --recurse-submodules,否则子模块缺失会导致后续运行异常;示例使用官方仓库地址。

    git clone --recurse-submodules https://github.com/microsoft/AIOpsLab.git
  4. 4安装项目依赖

    进入目录,指定 Python 3.11 作为 Poetry 环境,安装依赖并激活虚拟环境。若报 lock file 不兼容先跑 poetry lock。

    cd AIOpsLab
    poetry env use python3.11
    poetry install
    eval $(poetry env activate)
  5. 5准备 Kubernetes 集群

    用远程集群需先按 docs 里的 Ansible README 搭建集群,然后更新 config.yml 中的集群配置;kubectl context 需指向目标集群。

  6. 6运行本地 CLI 智能体

    启动交互式 CLI 后,输入 start 加问题 ID 开始任务,等待环境准备完成后用 submit("Yes") 提交解答。

    python3 cli.py
  7. 7启动远程服务

    在资源更大的远程机器上启动 AIOpsLab 服务,通过环境变量指定监听地址、端口和工作进程数。

    SERVICE_HOST=<YOUR_HOST> SERVICE_PORT=<YOUR_PORT> SERVICE_WORKERS=<YOUR_WORKERS> python service.py
  8. 8远程调用智能体

    先在远程机器启动 vLLM(可选),再从本地用 curl 提交 simulate 请求,指定问题、智能体与采样参数。

    chmod +x ./clients/launch_vllm.sh
    ./clients/launch_vllm.sh
    curl -X POST http://<YOUR_HOST>:<YOUR_PORT>/simulate -H "Content-Type: application/json" -d '{"problem_id": "misconfig_app_hotel_res-mitigation-1", "agent_name": "vllm", "max_steps": 10, "temperature": 0.7, "top_p": 0.9}'

关键配置

配置项必填说明示例
SERVICE_HOST是远程 AIOpsLab 服务监听的宿主机地址0.0.0.0
SERVICE_PORT是远程服务监听端口,curl 与客户端需一致8000
SERVICE_WORKERS否服务的工作进程数4
config.yml是集群连接与运行配置,搭建集群后需按其说明更新见仓库根目录 config.yml
agent_name是simulate 请求指定的智能体名称vllm
problem_id是simulate 请求指定的评测问题 IDmisconfig_app_hotel_res-mitigation-1

如何确认成功

远程服务可执行 curl http://<YOUR_HOST>:<YOUR_PORT>/health 检查健康状态,并可用 /problems、/agents 列出可用问题与智能体;本地 CLI 能正常 start 问题并 submit 解

常见问题

Q:poetry install 报 "lock file not compatible" 怎么办?

A:先执行 poetry lock 重新生成锁文件,然后再执行 poetry install。

Q:不想用 Poetry,可以用 pip 安装吗?

A:可以,在仓库根目录执行 pip install -e . 即可完成安装。

Q:如何更换 vLLM 使用的模型?

A:在运行前编辑 clients/launch_vllm.sh,改成你需要的模型配置后再执行该脚本。

Q:AIOpsLab 支持哪些集群?

A:支持任何 kubectl context 指向的远程 Kubernetes 集群,既包括云厂商集群,也可按 scripts/ansible/README.md 自建集群。

注意事项

  • 克隆仓库必须加 --recurse-submodules,否则子模块不会拉取。
  • Poetry 必须用官方安装脚本安装,apt 仓库中的版本过旧。
  • 运行前确认 kubectl context 已指向目标 Kubernetes 集群,并已在 config.yml 中更新对应配置。
  • 远程调用前需先启动 service.py 并确认 /health 可访问,使用 vLLM 时还需额外启动 vLLM 服务。

核心亮点

  • 提供端到端评测闭环,从故障注入到根因定位再到修复效果都有量化指标,避免只比单点算法
  • 智能体接口可插拔,能同时接入 LLM 智能体、强化学习策略和传统规则引擎做横向对比
  • 基于真实微服务与云环境抽象,故障场景贴近生产,复现实验成本低

不足之处

  • 项目处于早期成长阶段,生态和第三方场景库还不够丰富
  • 对非微软技术栈或自建环境的适配可能需要额外开发工作

适用场景

  • 研究团队对比不同 LLM 运维智能体在故障诊断任务上的准确率与修复耗时
  • 企业平台团队在自建云环境中预演智能体自动修复流程,评估上线风险
  • 教学场景中让学生用统一沙箱理解 AIOps 从检测到修复的完整链路

替代项目

Chaos Mesh、OpenRCA、AIOps Challenge

上一篇:agentmemoryrepo

下一篇:autocontext

同类项目推荐

hermes-rs 开源

用 Rust 重写 AI 智能体核心循环,让工具调用快如闪电。

A fast, self-contained AI agent runtime

★ 70 2026-08-09
Agent-Execution-Partnership 开源

给AI代理装上安全阀门,动作先审批、全程可追踪、事后可审计。

Agent Execution Partnership AEE is an open-source control plane that ensures every A···

★ 119 2026-08-09
Flowise 开源

像搭积木一样拖出 AI 助手,不用写一行代码

Build AI Agents, Visually

★ 55585 2026-08-09
MCP-SuperAssistant 开源

给所有主流AI聊天框装上MCP工具,秒变超级助手

Brings MCP to ChatGPT, DeepSeek, Perplexity, Grok, Gemini, Google AI Studio, OpenRou···

★ 2648 2026-08-09
langgraph-email-automation 开源

用多AI代理自动处理客服邮件,从接收到回复全流程搞定。

Multi AI agents for customer support email automation built with Langchain & Langgra···

★ 281 2026-08-09
stock-agent-ops 开源

用 LSTM 和智能体自动生成周度股票报告,省时省力

Designing end-to-end weekly stock report generation using LSTM and Agentic AI. Deplo···

★ 306 2026-08-09
monid 开源

一套接口接所有 Agent 工具,换模型不用重写

Monid - OpenRouter for agent tools. Join our community at https://discord.gg/rQzztcg···

★ 6222 2026-09-30
my-virtual-office 开源

把 AI 智能体放进 2D 办公室,可视化管理和协作

A self-hosted 2D AI workspace for AI Agents

★ 412 2026-08-09