aiops-agent-reproduction：用规格驱动的智能运维 Agent 实现告警到诊断报告全链路

核心能力与快速开始

★ 1 · Python

能做什么

覆盖告警接入、日志检索、知识库检索、诊断报告与案例沉淀的完整运维链路；认证与隔离支持本地注册登录、Argon2 密码、可撤销 token 以及按 owner/tenant 隔离业务数据；聊天模块提供持久 SSE 流式 Agent、工具调用审计与会话记忆压缩；知识库支持文档上传、切片、embedding 入 Milvus，并以 BM25L 与向量双路召回、RRF 融合与 rerank 精排；智能诊断由 LangGraph 编排 Plan → Execute → Replan，通过真实日志工具取证、结构化执行总账、证据门禁生成诊断报告并沉淀案例；MCP 模块连接官方腾讯云 CLS MCP 进行真实工具发现，按用户隔离并处理超时、重试与同名冲突，全程审计脱敏；提供 10 套 Java 电商故障 fixtures 用于可复现重放。

适用场景

作为信息采集装置运维场景的 Agent 诊断演示与参考实现，用于观察从告警接入到诊断报告的完整链路；借助 OpenSpec 规格与归档变更，学习规格驱动式 Agent 系统的设计过程；基于内置 fixtures 复现和讲解典型故障模式的日志、告警与 SOP 处理流程；作为引入 Milvus 双路召回、LangGraph 编排与 CLS MCP 工具对接的工程参考。

项目形态

开发框架

部署方式

README 给出本地五步启动方式：需 Docker Desktop 运行 etcd / MinIO / Milvus / Attu / Alertmanager 五容器，复制两份本地配置模板并填写凭据，然后通过 scripts/start-local.sh 或 start-local.bat 启动容器、uv sync、Alembic 迁移、官方 CLS MCP、FastAPI 与 Vite。凭据未填写时相关功能会明确报 unavailable。具体生产部署条件未说明。

主要依赖

Python 3.10+ 与 uv；Node.js 20+ 与 npm、npx（用于启动官方腾讯云 CLS MCP）；Docker Desktop。需在 config/user.project.json 中配置 LLM chat、embedding 与 rerank 的 API Key，以及 CLS MCP 的 secretId / secretKey 等凭据。具体硬件、模型与 API 成本未说明。

使用限制

README 明确说明仓库中的日志、告警和知识库文档均为演示构造数据，并非线上数据；真实模型、Milvus、CLS MCP 链路需自行配置凭据后在本机跑通，自动化测试仅证明代码合同；macOS 上使用 ClashX、Surge 等代理会干扰 127.0.0.1 请求，需设置 NO_PROXY；Windows 上需 Developer Mode 与 Git symlink 支持。其他性能边界、模型与 API 成本限制未说明。

许可证

MIT

最近推送

2026-10-09 08:56

资料检查：2026-10-10 07:00 · 卡片整理：2026-10-10 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容

职业应用

程序员

作为智能运维 Agent 的参考实现，程序员可复用其“告警接入 → 拉取日志取证 → 输出诊断报告”的 Agent 工作流，以及 LangGraph 编排的 Plan-Execute-Replan 诊断流程、SSE 流式聊天、Milvus 知识库与 BM25L 加向量双路召回等实现方式，用于构建或学习运维诊断类 Agent 系统。

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证