deep-search:基于 LangGraph + DeepAgents 的多智能体深度搜索系统

可用于联网搜索、数据库查询及知识库检索并生成分析报告。项目支持多智能体协作,通过FastAPI提供Web接口,能实时推送任务进度,输出Markdown/PDF格式报告。【此简介由AI生成】

Branch1Tags0

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