nextgenframes/triage-bob
GitHub: nextgenframes/triage-bob
一款轻量级值班事件响应控制台,利用 AI 将原始告警转化为可操作的响应简报,并支持工单调查记录和交接班文档生成。
Stars: 0 | Forks: 0
# Bob 值班
Bob on Call 是一个轻量级的黑客马拉松原型,用于实时on-call分诊。它将原始的生产环境告警转化为通俗易懂的英文首次响应简报,在未解决的工单之间记录调查上下文,并支持一键生成交接班文档。
## 功能展示
- 告警翻译器:将原始告警转化为严重程度、受影响区域、可能相关的文件、相关提交以及初步排查步骤
- Shift Brain:展示进行中的工单列表、即时重新简报以及每个工单的调查记录
- 交接班生成器:选择工单并导出结构化的 Markdown 交接班文档
- Bob 操作日志:可视化展示 Bob 进行翻译、映射代码库上下文以及起草后续步骤的运行过程
- 回归雷达:粘贴 PR diff,并将其与当前活跃的工单影响区域进行对比
- 本地回退机制:即使未配置模型凭证,也能提供实用的演示输出
## 本地使用
```
npm install
npm run dev
```
打开:
```
http://127.0.0.1:4173
```
如果该端口已被占用,Vite 将使用下一个可用端口并打印出相应的 URL。
## 生产环境构建
```
npm run build
node server.js
```
## IBM Bob 设置
本仓库包含项目级别的 IBM Bob 配置:
- `.bob/custom_modes.yaml` 定义了 `triage-partner` 自定义模式。
- `.bob/rules-triage-partner/` 定义了 Bob 应返回的 JSON 响应契约。
- `.bob/commands/triage-alert.md` 添加了一个用于原始告警分析的 `/triage-alert` 命令。
在 IBM Bob 中打开该项目时,Bob 应该会从 `.bob/custom_modes.yaml` 中检测到项目模式。当设置了以下环境变量时,应用后端也可以调用 IBM Bob 的网关端点:
```
IBM_BOB_API_URL=https://your-bob-endpoint.example
IBM_BOB_API_KEY=your_bob_token
IBM_BOB_MODE=triage-partner
IBM_BOB_PROJECT_ID=optional_project_id
```
如果未配置这些值,应用将回退到下述可选的模型提供商,然后再回退到本地的演示分诊手册。
## 可选模型设置
API 可以通过 DashScope 兼容 OpenAI 的端点调用 Qwen:
```
QWEN_API_KEY=your_qwen_or_dashscope_key
QWEN_MODEL=qwen-plus
QWEN_BASE_URL=https://dashscope-intl.aliyuncs.com/compatible-mode/v1
```
`DASHSCOPE_API_KEY` 也可以用来代替 `QWEN_API_KEY`。
可选的 OpenRouter 回退配置:
```
OPENROUTER_API_KEY=your_openrouter_key
OPENROUTER_MODEL=qwen/qwen3.6-plus
OPENROUTER_SITE_URL=https://your-site.example
OPENROUTER_APP_NAME=Bob on Call
```
## 可选 Supabase 设置
在您的 Supabase SQL 编辑器中运行 `supabase-schema.sql` 中的 SQL 语句。应用通过服务端 API 使用服务端密钥进行数据写入。
```
SUPABASE_URL=https://your-project-ref.supabase.co
SUPABASE_SERVICE_ROLE_KEY=your_server_side_key
```
## 演示流程
1. 从结账延迟告警开始。
2. 运行告警翻译器,并查看生成的通俗易懂的摘要、受影响的文件以及前三个检查项。
3. 切换到 Shift Brain,添加一条记录,并展示 Bob 对该工单的重新简报。
4. 打开交接班生成器,选择工单,然后复制或下载 Markdown 交接班文档。
5. 使用回归雷达,展示 Bob 如何将 PR diff 与当前活跃的工单历史进行对比。
标签:CISA项目, DashScope, DevSecOps, DLL 劫持, GNU通用公共许可证, Hackathon原型, IBM Bob, LLM集成, Markdown, MITM代理, Node.js, PR差异比对, Qwen, SRE工具, Vite, 一键交接报告, 上游代理, 代码提交关联, 值班运维, 受影响区域分析, 告警分发与翻译, 告警噪音抑制, 回归雷达, 大语言模型, 安全事件响应, 安全运营(SecOps), 实时报警分类, 密码管理, 生成式AI助手, 自定义脚本, 运维自动化, 镜像安全