一个基于 RAG + LLM 的智能 Bug 分析系统,帮助快速定位问题根因并提供修复建议。
- 🔍 智能分析:自动解析堆栈、提取关键实体、分类 Bug 类型
- 📚 知识库检索:多路召回(代码、历史Case、日志模式)
- 🤖 LLM 推理:结合上下文进行根因分析和修复建议
- 📊 结构化输出:问题定位、根因、修复建议、影响评估
- 💻 多种交互:API 服务 + CLI 工具
# 克隆项目
cd debug-agent
# 创建虚拟环境
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
# 安装依赖
pip install -r requirements.txt# 复制配置模板
cp .env.example .env
# 编辑 .env 文件,填入 OpenAI API Key
# OPENAI_API_KEY=sk-your-api-key-herepython scripts/init_knowledge_base.py方式一:API 服务
python main.py
# 或
python cli.py serve访问 http://localhost:8000/docs 查看 API 文档
方式二:命令行
# 单次分析
python cli.py analyze -e "Redis connection timeout" -d "用户反馈接口超时"
# 交互模式
python cli.py interactive
# 查看知识库统计
python cli.py stats方式三:Docker
docker-compose up -dcurl -X POST "http://localhost:8000/api/v1/analyze" \
-H "Content-Type: application/json" \
-d '{
"error_info": {
"error_message": "Redis connection timeout",
"stack_trace": "Traceback...",
"trace_id": "abc123"
},
"context": {
"user_description": "用户反馈代码补全接口响应超时"
},
"severity": "P2"
}'curl -X POST "http://localhost:8000/api/v1/cases" \
-H "Content-Type: application/json" \
-d '{
"case_id": "CASE-2024-100",
"created_at": "2024-01-15T10:00:00",
"problem": {
"title": "Redis 连接超时",
"description": "高并发场景下 Redis 连接池耗尽"
},
"resolution": {
"root_cause": "连接池配置过小",
"fix_type": "config_change",
"fix_detail": "增加连接池大小"
},
"tags": ["redis", "performance"]
}'debug-agent/
├── main.py # FastAPI 应用入口
├── cli.py # CLI 工具
├── requirements.txt # Python 依赖
├── config/
│ └── settings.py # 配置管理
├── src/
│ ├── api/
│ │ └── routes.py # API 路由
│ ├── core/
│ │ ├── preprocessor.py # 预处理(堆栈解析、实体提取)
│ │ ├── retriever.py # 多路检索
│ │ └── analyzer.py # LLM 分析
│ ├── models/
│ │ └── schemas.py # 数据模型
│ ├── storage/
│ │ └── vector_store.py # 向量存储
│ └── service.py # 核心服务
├── scripts/
│ └── init_knowledge_base.py # 知识库初始化
├── Dockerfile
└── docker-compose.yml
| 环境变量 | 说明 | 默认值 |
|---|---|---|
OPENAI_API_KEY |
OpenAI API Key | 必填 |
OPENAI_BASE_URL |
OpenAI API 代理地址 | - |
LLM_MODEL |
LLM 模型名称 | gpt-4-turbo-preview |
API_PORT |
API 服务端口 | 8000 |
LOG_LEVEL |
日志级别 | INFO |
MIT