可用于联网搜索、数据库查询及知识库检索并生成分析报告。项目支持多智能体协作,通过FastAPI提供Web接口,能实时推送任务进度,输出Markdown/PDF格式报告。【此简介由AI生成】
Access rate limit exceeded. Please log in to continue.
Deep Search 🔍
多智能体协作的深度搜索系统 — 基于 LangGraph + DeepAgents 构建,支持联网搜索、数据库查询、RAGFlow 知识库检索,并自动生成 Markdown / PDF 分析报告。
功能特性
| 功能 | 说明 |
|---|---|
| 🌐 网络搜索 | 通过 Tavily API 从互联网检索公开信息 |
| 🗄️ 数据库查询 | 直接连接 MySQL,执行自定义 SQL,获取业务数据 |
| 📚 RAGFlow 知识库 | 接入 RAGFlow 私有知识库,检索企业内部文档 |
| 🤖 多智能体协作 | 主智能体协调 3 个子智能体,分步完成任务 |
| 📝 自动报告生成 | 支持输出 Markdown、PDF 格式的分析报告 |
| 🌐 Web API | FastAPI 提供 RESTful 接口,支持流式响应 |
| 🔌 WebSocket 推送 | 实时推送任务进度、中间结果到前端 |
快速开始
1. 环境准备
# Python >= 3.12
pip install uv
uv sync
2. 配置环境变量
# 复制环境变量模板
cp .env.example .env
# 编辑 .env,填入你的 API 密钥
# OPENAI_API_KEY - LLM API 密钥(必填)
# TAVILY_API_KEY - Tavily 搜索密钥(推荐)
# RAGFLOW_API_KEY - RAGFlow 密钥(可选)
# MYSQL_PASSWORD - 数据库密码(可选)
3. 运行
# 直接运行主智能体(命令行)
python main.py
# 或启动 Web API 服务
uvicorn api.server:app --host 0.0.0.0 --port 8000
项目结构
deep-search/
├── agent/ # 智能体核心
│ ├── main_agent.py # 主智能体(协调者)
│ ├── llm.py # LLM 模型初始化
│ ├── prompts.py # 提示词模板
│ └── sub_agents/ # 子智能体
│ ├── network_search_agent.py # 网络搜索
│ ├── database_query_agent.py # 数据库查询
│ └── knowledge_base_agent.py # RAGFlow 知识库
├── api/ # Web API 层
│ ├── server.py # FastAPI 服务入口
│ ├── context.py # 请求上下文管理
│ ├── logger.py # 日志配置
│ └── monitor.py # 进度推送
├── client/ # 数据库客户端
├── config/ # 应用配置(Pydantic Settings)
├── repository/ # 数据仓库层
├── tools/ # 工具函数
│ ├── markdown_tools.py # Markdown 生成
│ ├── pdf_tools.py # PDF 转换
│ ├── tavily_tools.py # Tavily 搜索
│ ├── mysql_tools.py # MySQL 查询
│ ├── ragflow_tools.py # RAGFlow 交互
│ └── upload_file_read_tool.py # 上传文件读取
├── utils/ # 工具函数
│ ├── md2pdf.py # Markdown → PDF
│ └── path_utils.py # 路径工具
├── prompt/ # 智能体提示词
├── output/ # 报告输出目录(gitignore)
├── main.py # 命令行入口
├── pyproject.toml # 项目依赖
├── .env.example # 环境变量模板
└── .gitignore
智能体工作流程
┌────────────────────────────────────────────────┐
│ 用户提问 │
└────────────────┬───────────────────────────────┘
│
┌───────▼────────┐
│ 主智能体 │ ← 协调者,负责任务拆解
│ (Coordinator) │
└──┬────┬────┬───┘
│ │ │
┌──────▼┐ ┌─▼───┐ ┌▼────────┐
│ 网络 │ │数据库│ │RAGFlow │
│ 搜索 │ │查询 │ │知识库 │
└──────┬┘ └──┬──┘ └──┬──────┘
│ │ │
┌──▼──────▼───────▼───┐
│ 信息汇总 & 分析 │
└────────┬────────────┘
│
┌────────▼────────┐
│ 生成报告 │
│ Markdown / PDF │
└────────────────┘
配置参考
| 环境变量 | 必填 | 默认值 | 说明 |
|---|---|---|---|
OPENAI_API_KEY |
✅ | — | LLM API 密钥 |
OPENAI_BASE_URL |
❌ | https://dashscope.aliyuncs.com/... |
API 地址 |
MODEL_NAME |
❌ | gpt-4o-mini |
模型名称 |
TAVILY_API_KEY |
❌ | — | Tavily 搜索密钥 |
RAGFLOW_API_URL |
❌ | — | RAGFlow 地址 |
RAGFLOW_API_KEY |
❌ | — | RAGFlow 密钥 |
MYSQL_USER |
❌ | root |
数据库用户 |
MYSQL_PASSWORD |
❌ | — | 数据库密码 |
MYSQL_DATABASE |
❌ | — | 数据库名 |
SERVER_PORT |
❌ | 8000 |
API 端口 |
技术栈
- LangGraph — 智能体编排与状态管理
- DeepAgents — 多智能体框架
- FastAPI — Web API 服务
- LangChain — LLM 调用链
- Pydantic Settings — 配置管理
- Tavily — 网络搜索 API
- RAGFlow SDK — 知识库接入
- SQLAlchemy / asyncmy — 数据库访问
- MarkdownPdf — 报告导出
许可
MIT License
Introduction
可用于联网搜索、数据库查询及知识库检索并生成分析报告。项目支持多智能体协作,通过FastAPI提供Web接口,能实时推送任务进度,输出Markdown/PDF格式报告。【此简介由AI生成】
Customize your domain