Derisk

OpenDeRisk

OpenDeRisk 是一款 AI 原生风险情报系统，旨在作为应用系统的智能管家，提供全天候、全面且深入的保护。

功能

1. DeepResearch 根因分析： 通过深入分析日志、跟踪信息和代码，快速定位根本原因。
2. 可视化证据链： 全面呈现诊断流程和证据链，便于做出清晰、准确的判断。
3. 多 Agent 协作： SRE-Agent、Code-Agent、ReportAgent、Vis-Agent 和 Data-Agent 协同工作。
4. 开源架构： 采用完全开放的架构，支持在开源项目中复用框架和代码。

架构

简介

系统采用多 Agent 架构。目前，代码主要实现了图中高亮的组件。告警感知基于 Microsoft 的开源 OpenRCA 数据集。解压后的数据集约为 26GB。我们在此数据集上通过多 Agent 协作进行根因分析，并由 Code-Agent 动态编写代码完成最终分析。

技术实现

数据层： 从 GitHub 拉取大规模 OpenRCA 数据集（20GB），在本地解压并进行分析处理。

逻辑层： 采用多 Agent 架构，由 SRE-Agent、Code-Agent、ReportAgent、Vis-Agent 和 Data-Agent 协作开展深入的 DeepResearch RCA（根因分析）。

可视化层： 使用 Vis 协议动态呈现整个处理流程和证据链，以及多角色协作与切换的过程。

OpenDeRisk 中的数字员工（Agent）

安装（推荐）

使用 curl 安装

# Download and install latest version
curl -fsSL https://raw.githubusercontent.com/derisk-ai/OpenDerisk/main/install.sh | bash

配置文件

安装后，系统会自动初始化默认配置文件： ~/.openderisk/configs/derisk-proxy-aliyun.toml

编辑此文件并设置 API 密钥：

vi ~/.openderisk/configs/derisk-proxy-aliyun.toml

启动

openderisk-server  

从源代码安装（开发版）

安装 uv（必需）

macOS/Linux：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows：

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

克隆并安装依赖项

git clone https://github.com/derisk-ai/OpenDerisk.git

cd OpenDerisk

# Install Dependencies with uv
uv sync --all-packages --frozen \
    --extra "base" \
    --extra "proxy_openai" \
    --extra "rag" \
    --extra "storage_chromadb" \
    --extra "derisks" \
    --extra "storage_oss2" \
    --extra "client" \
    --extra "ext_base" \
    --extra "channel_dingtalk"

注意：channel_dingtalk 是可选的。如果不需要钉钉频道支持，可以跳过此步骤。

启动服务

🚀 快速开始（零配置，推荐）

无需任何配置文件即可启动：

# Method 1: Use quickstart command
uv run derisk quickstart

# Method 2: Use startup script
./start.sh

# Method 3: Specify port
uv run derisk quickstart -p 8888

启动后，访问 http://localhost:7777，通过 Web UI 配置模型和设置。

如需详细说明，请参阅：快速入门指南

📝 使用配置文件启动

在 derisk-proxy-aliyun.toml 中配置 API_KEY，然后运行：

注意：默认情况下，我们使用 OpenRCA 的 Telecom 数据集。通过以下命令下载： gdown https://drive.google.com/uc?id=1cyOKpqyAP4fy-QiJ6a_cKuwR7D46zyVe

下载后，将数据集移至 pilot/datasets/

运行启动命令：

# Start with configuration file
uv run derisk quickstart -c configs/derisk-proxy-aliyun.toml

# Or use traditional method
uv run python packages/derisk-app/src/derisk_app/derisk_server.py --config configs/derisk-proxy-aliyun.toml

访问 Web UI

打开浏览器并访问 http://localhost:7777

使用模式

• AI-SRE（OpenRCA）
  • 注意：我们使用 OpenRCA 数据集中的 Bank 数据集
  • 下载：gdown https://drive.google.com/uc?id=1enBrdPT3wLG94ITGbSOwUFg9fkLR-16R
  • 将数据集放入 ${derisk}/pilot/datasets
• 火焰图助手
  • 上传本地应用中的火焰图（Java/Python）进行分析
• DataExpert
  • 上传指标、日志、追踪信息或 Excel 数据，进行对话式分析

开发

• Agent 开发
  • 参考 derisk-ext.agent.agents 下的实现
• 工具开发
  • 技能
  • MCP（模型上下文协议）
• DeRisk-Skills
  • derisk-skills

执行结果

引用

如果您觉得此仓库对您有帮助，请引用：

@misc{di2025openderiskindustrialframeworkaidriven,
      title={OpenDerisk: An Industrial Framework for AI-Driven SRE, with Design, Implementation, and Case Studies}, 
      author={Peng Di and Faqiang Chen and Xiao Bai and Hongjun Yang and Qingfeng Li and Ganglin Wei and Jian Mou and Feng Shi and Keting Chen and Peng Tang and Zhitao Shen and Zheng Li and Wenhui Shi and Junwei Guo and Hang Yu},
      year={2025},
      eprint={2510.13561},
      archivePrefix={arXiv},
      primaryClass={cs.SE},
      url={https://arxiv.org/abs/2510.13561}, 
}

致谢

• DB-GPT
• GPT-Vis
• MetaGPT
• OpenRCA

OpenDeRisk-AI 社区致力于构建 AI 原生风险智能系统。🛡️ 我们希望社区能够为您提供更好的服务，也希望您能加入我们，共同创造更美好的未来。🤝

社区群组

加入我们的钉钉群，与其他开发者分享您的经验！