OpsKeeper
集成

顺滑接入你已经在跑的工具。

OpsKeeper 集成 AgentTeams Dashboard、Grafana 栈和标准数据平面。新 Worker 通过 stdio MCP 代理加入 —— 不绑定任何 SDK。

AgentTeams Dashboard

agentteams-plugin-installer 把 AgentTeams Dashboard 变成 OpsKeeper 的插件控制台。在文件系统 PluginRegistry 之上增加 5 个扩展点和一套 HTTP API。

  • 扩展点：sidebar-menu、route、dashboard-widget、detail-panel、toolbar
  • HTTP API：/v1/plugins 支持 list / get / install / uninstall / enable / disable / sync / push
  • 硬性限制：10 MB zip、50 MB 解压、1000 文件，zip-slip 防护

OpsKeeper TeamHarness

Worker 侧插件，让六个 Operational Worker 通过 stdio MCP 代理调用 OpsKeeper。17 个 MCP 工具，Bearer + HMAC + W3C traceparent 三重鉴权。

  • stdio MCP server，兼容 Streamable HTTP
  • FastAPI 路由 /api/opskeeper-teamharness/{health,sync,install-plugin}
  • 通过 qwenpaw plugin install 实现热部署

可观测

与 Grafana 栈深度集成 —— Prometheus 抓取、Loki 日志流、Tempo 追踪，并为闭环预置 Grafana 仪表盘。

  • 仓库自带抓取配置
  • 按 trace_id 关联日志 / 指标 / 追踪
  • 预置仪表盘：闭环、审计账本、技能健康度

数据平面

PostgreSQL 做事件记忆和 append-only 账本，Qdrant 做向量检索，Nacos 做技能注册中心。

  • PostgreSQL：账本 + 通过 MySQL GET_LOCK 实现状态机串行化
  • Qdrant：关键字召回 + RRF 融合排序，保留候选决策证据
  • Nacos Config：HTTP 2.x API + 本地降级 + 30 秒热加载

工具链

W3C traceparent 端到端传递，覆盖 Worker → MCP 代理 → 控制平面 → Web Console。兼容 OpenTelemetry。

  • OpenTelemetry SDK + W3C traceparent
  • 跨 stdio MCP 边界传递
  • 为 AgentLoop / LoongSuite 提供 OTLP 适配器（路线图上）

安全

HMAC 链式审计账本，每日 ndjson 导出，可选 Nacos 历史同步，所有 API 都有基于角色的鉴权。

  • append-only HMAC 链式账本
  • 每日 ndjson 导出，可选 Nacos 历史同步
  • 插件端点使用 Bearer + HMAC
stdio MCP

任何 Worker，同一套协议。

OpsKeeper Worker 插件通过 stdio 讲 JSON-RPC。发现 17 个工具，传递 W3C traceparent，用 Bearer + HMAC 鉴权。Streamable HTTP 在路线图上。

tools/list
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}
// → opskeeper-teamharness 暴露 17 个工具：
//   loop.investigate
//   loop.correlate
//   recovery.verify
//   recovery.execute
//   metric.query
//   incident.list / incident.get
//   postgres.analyze_status
//   host.get_load / host.get_processes / host.restart_service
//   knowledge.query / knowledge.write
//   hitl.decide
//   state.put / state.get
//   incident.record
安装

两条命令，你就有了一个 Worker。

安装 Dashboard 插件，或为任何 Worker 直接跑 MCP 代理。配合 qwenpaw plugin install 实现热部署。

install · plugin + mcp
# 构建 + 安装 AgentTeams Dashboard 插件
make build-plugins                     # zip 产物在 dist/plugins/

# 或者直接为任何 Worker 跑 stdio MCP 代理
cd plugins/opskeeper-teamharness
OPSKEEPER_BACKEND_URL=http://localhost:8080 \
OPSKEEPER_GATEWAY_KEY="$GATEWAY_KEY" \
python3 mcp/server.py