knowledgeops-agent — Ops-Ready RAG Agent Stack

简介

knowledgeops-agent 是带“运维基线”的 agent 全栈：Docker Compose 一键拉起 API + 控制台，并配套 MySQL/Redis/RabbitMQ；还提供独立的可观测性栈。

• 适合谁： 希望从一开始就把运维基线带上的团队（compose/迁移/日志/指标/追踪）
• 可搭配： Docker & Docker Compose；Java（Spring Boot）+ Vue 控制台；需要 OpenAI 兼容的 API key（见 README）
• 准备时间： 20–45 分钟

实战建议

• GitHub：204 stars · 11 forks；最近更新 2026-05-12（GitHub API 验证）。
• README 提供安装脚本与 docker compose up --build -d 的直接启动方式，控制台在 http://localhost:8088。
• README 给出独立可观测性 compose：Prometheus / Loki / Tempo / Alertmanager。

主要内容

把它落地成“真能跑的服务”，建议遵循它的 ops-first 思路：

1. 先用 Compose 跑通基线服务（应用 + MySQL/Redis/RabbitMQ），再做定制。
2. 面向真实用户时务必轮换 demo key，并接入正规的密钥管理。
3. 早决定是否启用可观测性栈；如果需要，尽早打开，避免后期补 trace。
4. 把迁移（Flyway）与回归脚本当作发布闸门，不通过就不发版。

这个仓库的价值在于：它把 agent app 当作生产服务来设计，而不是 notebook 示例。

FAQ

有一键安装吗？ 答：有。README 提供 scripts/install_mac.sh 以及 Windows 脚本，会引导生成 .env 并启动 Compose。

默认包含哪些服务？ 答：README 列出应用 + MySQL + Redis + RabbitMQ + Web 控制台；可观测性栈在独立 compose 文件里。

启动后从哪访问？ 答：README 写明控制台 http://localhost:8088，后端 API http://localhost:8080。