🏠 项目架构图

📂 项目结构

graph-rag-agent/├── agent/                  # 🤖 Agent 模块 - 核心交互层│   ├── base.py             # Agent 基类│   ├── graph_agent.py      # 基于图结构的 Agent│   ├── hybrid_agent.py     # 混合搜索 Agent│   ├── naive_rag_agent.py  # 简单向量检索 Agent│   ├── deep_research_agent.py # 深度研究 Agent│   ├── fusion_agent.py     # 多 Agent 协作 Agent│   └── agent_coordinator.py # 多 Agent 协调器├── assets/                 # 🖼️ 静态资源│   ├── deepsearch.svg      # rag演进图│   └── start.md            # 快速开始文档├── build/                  # 🏗️ 知识图谱构建模块│   ├── main.py             # 构建入口│   ├── build_graph.py      # 基础图谱构建│   ├── build_index_and_community.py # 索引和社区构建│   ├── build_chunk_index.py # 文本块索引构建│   ├── incremental/        # 增量更新子模块│   └── incremental_update.py # 增量更新管理├── CacheManage/            # 📦 缓存管理模块│   ├── manager.py          # 统一缓存管理器│   ├── backends/           # 存储后端│   ├── models/             # 数据模型│   └── strategies/         # 缓存键生成策略├── community/              # 🔍 社区检测与摘要模块│   ├── detector/           # 社区检测算法│   └── summary/            # 社区摘要生成├── config/                 # ⚙️ 配置模块│   ├── neo4jdb.py          # 数据库连接管理│   ├── prompt.py           # 提示模板│   └── settings.py         # 全局配置├── evaluator/              # 📊 评估系统│   ├── core/               # 评估核心组件│   ├── metrics/            # 评估指标实现│   └── test/               # 评估测试脚本├── frontend/               # 🖥️ 前端界面│   ├── app.py              # 应用入口│   ├── components/         # UI组件│   └── utils/              # 前端工具├── graph/                  # 📈 图谱构建模块│   ├── core/               # 核心组件│   ├── extraction/         # 实体关系提取│   ├── indexing/           # 索引管理│   └── processing/         # 实体处理├── model/                  # 🧩 模型管理│   └── get_models.py       # 模型初始化├── processor/              # 📄 文档处理器│   ├── document_processor.py # 文档处理核心│   ├── file_reader.py      # 多格式文件读取│   └── text_chunker.py     # 文本分块├── search/                 # 🔎 搜索模块│   ├── local_search.py     # 本地搜索│   ├── global_search.py    # 全局搜索│   └── tool/               # 搜索工具集│       ├── naive_search_tool.py    # 简单搜索│       ├── deep_research_tool.py   # 深度研究工具│       └── reasoning/              # 推理组件├── server/                 # 🖧 后端服务│   ├── main.py             # FastAPI 应用入口│   ├── models/             # 数据模型│   ├── routers/            # API 路由│   └── services/           # 业务逻辑└── test/                   # 🧪 测试模块    ├── search_with_stream.py    # 流式输出测试    └── search_without_stream.py # 标准输出测试

🚀 相关资源

✨ 项目亮点

🏁 快速开始

🧰 功能模块

图谱构建与管理

GraphRAG 实现

DeepSearch 融合

多种 Agent 实现

系统评估与监控

前后端实现

🖥️ 简单演示

终端测试输出：

cd test/python search_with_stream.py# 本例为测试FusionGraphRAGAgent的输出，其他Agent可以在测试脚本中删除注释自行测试开始测试: 2025-04-05 21:55:04===== 开始流式Agent测试 =====已加载增强版深度研究工具===== 测试查询: 优秀学生的申请条件是什么？ =====[测试] FusionGraphRAGAgent - 流式 - 查询:'优秀学生的申请条件是什么？'开始接收流式输出 (最长等待 300 秒)...性能指标 - fast_cache_check: 1.0043sDEBUG - LLM关键词结果: {"low_level": ["student","institutions"],"high_level": ["comparison","criteria","educat...Building prefix dict from the default dictionary ...Loading model from cache /tmp/jieba.cacheLoading model cost 0.570 seconds.Prefix dict has been built successfully.构建查询图谱完成，包含 5 个实体和 0 个关系，耗时 0.00秒DEBUG - LLM关键词结果: {"low_level": ["Institution A","excellent student"],"high_level": ["criteria","define", ...[双路径搜索] LLM评估: 两种结果均有价值，合并结果DEBUG - LLM关键词结果: {"low_level": ["Institution B"],"high_level": ["criteria","excellent student","definitio...[双路径搜索] LLM评估: 精确查询结果更具体更有价值DEBUG - LLM关键词结果: {"low_level": ["student","institutions"],"high_level": ["comparison","criteria","excell...[验证] 答案通过关键词相关性检查DEBUG - LLM关键词结果: {"low_level": ["student admission","top universities"],"high_level": ["criteria","excell...构建查询图谱完成，包含 5 个实体和 0 个关系，耗时 0.00秒DEBUG - LLM关键词结果: {"low_level": ["excellent student","top universities"],"high_level": ["academic qualifica...[双路径搜索] LLM评估: 精确查询结果更具体更有价值DEBUG - LLM关键词结果: {"low_level": ["student admission","top universities"],"high_level": ["extracurricular ac...[双路径搜索] LLM评估: 精确查询结果更具体更有价值DEBUG - LLM关键词结果: {"low_level": ["student","universities"],"high_level": ["admission criteria","excellence...[验证] 答案未包含任何高级关键词: ['admission criteria', 'excellence', 'higher education']达到最大等待时间 300 秒，提前结束接收[完成] 流式查询完成- 总耗时: 414.15秒- 首块延迟: 1.00秒- 数据块数: 14个- 总字符数: 766字符结果:**正在分析问题和制定检索计划**...**检索计划制定完成**- 复杂度评估: 0.60- 需要全局视图: 是- 需要关系路径追踪: 否- 包含时间相关内容: 否- 涉及知识领域: Education, Admission Policies, Student Assessment**执行任务 1/5**: exploration - Comparison of excellent student criteria across different institutions**开始深度探索**...✓ 深度探索完成**执行任务 2/5**: local_search - Specific academic achievements or qualifications required for recognition as an excellent student✓ 本地搜索完成**执行任务 3/5**: global_search - General application criteria for excellent students in various educational institutions✓ 全局搜索完成**执行任务 4/5**: local_search - Policies governing how excellent students are defined and assessed✓ 本地搜索完成**执行任务 5/5**: exploration - Detailed criteria for excellent student admission in top universities**开始深度探索**...✓ 深度探索完成===== 测试查询: 学业奖学金有多少钱？ =====[测试] FusionGraphRAGAgent - 流式 - 查询: '学业奖学金有多少钱？'开始接收流式输出 (最长等待 300 秒)...性能指标 - fast_cache_check: 0.9272sDEBUG - LLM关键词结果: {"low_level": ["institutions","scholarship offerings"],"high_level": ["education","schol...构建查询图谱完成，包含 5 个实体和 0 个关系，耗时 0.00秒DEBUG - LLM关键词结果: {"low_level": ["institutions","scholarships"],"high_level": ["notable","offer","educati...[双路径搜索] LLM评估: 带知识库名查询结果更具体更有价值DEBUG - LLM关键词结果: {"low_level": ["institutions","scholarships"],"high_level": ["types"]}[双路径搜索] LLM评估: 带知识库名查询结果更具体更有价值DEBUG - LLM关键词结果: {"low_level": ["institutions","scholarship offerings"],"high_level": ["education","finan...[验证] 答案通过关键词相关性检查[完成] 流式查询完成- 总耗时: 226.51秒- 首块延迟: 0.93秒- 数据块数: 18个- 总字符数: 1230字符结果:**正在分析问题和制定检索计划**...**检索计划制定完成**- 复杂度评估: 0.50- 需要全局视图: 是- 需要关系路径追踪: 否- 包含时间相关内容: 否- 涉及知识领域: Education, Finance, Scholarship Programs**执行任务 1/6**: exploration - Explore different institutions and their scholarship offerings**开始深度探索**...✓ 深度探索完成**执行任务 2/6**: local_search - Average amount of funds awarded by academic scholarships✓ 本地搜索完成**执行任务 3/6**: global_search - Statistics on academic scholarship funding trends✓ 全局搜索完成**执行任务 4/6**: global_search - Overview of academic scholarships✓ 全局搜索完成**执行任务 5/6**: global_search - Types and amounts of financial aid availablefor students✓ 全局搜索完成**执行任务 6/6**: local_search - Financial aid offices or resourcesfor further information✓ 本地搜索完成**正在整合所有检索结果，生成最终答案**...**正在整合所有检索结果，生成最终答案**...根据提供的检索结果，我们可以了解到，在华东理工大学，学业奖学金的金额是根据不同等级划分的，每种等级的奖学金金额和比例如下：1.**特等奖学金**：5000元/人/学年，占领取人数的2%。2.**一等奖学金**：3000元/人/学年，占领取人数的3%。3.**二等奖学金**：2000元/人/学年，占领取人数的10%。4.**三等奖学金**：1000元/人/学年，占领取人数的25%。根据这些不同等级的奖学金金额和比例，可以通过加权平均计算出每位获奖学生的平均奖学金金额大约为640元。这些奖学金的设立和分发是依据学生的综合成绩和德育分进行的，学校通过这种方式激励和支持品学兼优的学生。对于每位申请奖学金的学生，学校设有严格的评选标准和程序，以确保奖学金颁发给符合条件的学生。另外，除了学业奖学金，华东理工大学还提供其他类型的资助项目，如国家助学贷款和励志奖学金，帮助经济困难的学生完成学业。若有其他关于奖学金种类或申请流程的问题，请参阅相关学校部门的官方指引或进一步咨询学校的学生资助管理中心。===== 测试查询: 大学英语考试的标准是什么？=====[测试] FusionGraphRAGAgent - 流式 - 查询:'大学英语考试的标准是什么？'开始接收流式输出 (最长等待 300 秒)...关键词提取失败: Expecting value: line 1 column 1 (char 0)性能指标 - fast_cache_check: 1.0581sDEBUG - LLM关键词结果: {"low_level": ["各国","大学","英语考试"],"high_level": ["标准","比较"]}构建查询图谱完成，包含 5 个实体和 0 个关系，耗时 0.00秒DEBUG - LLM关键词结果: {"low_level": ["大学","英语考试","国家"],"high_level": ["教育标准","对比分析","语言能力评估"]}[双路径搜索] LLM评估: 精确查询结果更具体更有价值DEBUG - LLM关键词结果: {"low_level": ["大学","英语考试","各国"],"high_level": ["难度","形式","标准"]}[双路径搜索] LLM评估: 带知识库名查询结果更具体更有价值DEBUG - LLM关键词结果: {"low_level": [],"high_level": ["各国","大学","英语考试","标准","比较"]}[验证] 答案通过关键词相关性检查[完成] 流式查询完成- 总耗时: 224.52秒- 首块延迟: 1.06秒- 数据块数: 16个- 总字符数: 1126字符结果:**正在分析问题和制定检索计划**...**检索计划制定完成**- 复杂度评估: 0.70- 需要全局视图: 是- 需要关系路径追踪: 否- 包含时间相关内容: 是- 涉及知识领域: 教育制度, 语言学习, 考试评估**执行任务 1/5**: global_search - 大学英语考试对学生的影响✓ 全局搜索完成**执行任务 2/5**: local_search - 时间上大学英语考试标准的变化✓ 本地搜索完成**执行任务 3/5**: exploration - 各国大学英语考试标准比较**开始深度探索**...✓ 深度探索完成**执行任务 4/5**: global_search - 大学英语考试的一般概况✓ 全局搜索完成**执行任务 5/5**: local_search - 大学英语考试的标准详细介绍✓ 本地搜索完成**正在整合所有检索结果，生成最终答案**...**正在整合所有检索结果，生成最终答案**...### 大学英语考试的标准根据本地和全球检索结果，我们可以了解大学英语考试标准的几个主要方面，包括考试目的、免修条件、课程设置与考核方法。#### 1. 背景与目标大学英语课程的目标是培养学生的英语应用能力、学术或职业英语交流能力以及跨文化交际能力，以满足不同层次学生的学习需求，提高教学质量。[结果 1]#### 2. 考试免修标准大学英语免修条件与国家统一考试成绩相关：-**国家大学英语四级考试**: 四级成绩达到480分以上者，可以免考《大学英语》学位考试。[结果 2]-**国家大学英语六级考试**: 六级成绩达到425分以上者，同样可以免考《大学英语》学位考试。[结果 2]#### 3. 课程设置与考核大学英语课程由三个阶段的课程组成，所有参与课程的学生需通过各阶段的期末考核，并修满学分。[结果 1, 结果 2]#### 4. 学位考试安排学位考试通常安排在毕业前的最后学年，未通过的学生可参加补考。[结果 2]#### 5. 国际标准比较各国采用不同的英语考试，例如，英国通常使用雅思（IELTS），美国常用托福（TOEFL）。各国考试虽形式不同，但都包括听、说、读、写四个部分。其目的是确保学生能够在英语环境中顺利学习。[探索结果 1]### 总结大学英语考试标准主要以国家统一考试成绩为依据，通过分级和补考等机制确保学生英语能力的培养。另外，各国在英语考试标准上有所差异，这反映在考试方式和评分上。总体来说，大学英语考试的核心标准在于评估学生的英语能力，以便适应用语言的学术或专业环境。===== 测试查询: 小明同学旷课了30学时，又私藏了吹风机，他还殴打了同学，他还能评选国家奖学金吗？=====[测试] FusionGraphRAGAgent - 流式 - 查询:'小明同学旷课了30学时，又私藏了吹风机，他还殴打了同学，他还能评选国家奖学金吗？'开始接收流式输出 (最长等待 300 秒)...性能指标 - fast_cache_check: 1.1123s已接收 20 块，共 824 字符，耗时 101.35 秒DEBUG - LLM关键词结果: {"low_level": ["旷课","私藏物品","暴力行为"],"high_level": ["综合处理","校园纪律管理","行为规范"]}构建查询图谱完成，包含 5 个实体和 0 个关系，耗时 0.00秒DEBUG - LLM关键词结果: {"low_level": ["旷课","学校"],"high_level": ["处理措施","行为"]}[双路径搜索] LLM评估: 精确查询结果更具体更有价值DEBUG - LLM关键词结果: {"low_level": ["私藏物品","学校"],"high_level": ["处理措施","行为","规章制度"]}[双路径搜索] LLM评估: 精确查询结果更具体更有价值DEBUG - LLM关键词结果: {"low_level": [],"high_level": ["旷课","私藏物品","暴力行为","综合处理","学校"]}[验证] 答案通过关键词相关性检查[完成] 流式查询完成- 总耗时: 291.64秒- 首块延迟: 1.11秒- 数据块数: 32个- 总字符数: 2011字符结果:**正在分析问题和制定检索计划**...**检索计划制定完成**- 复杂度评估: 0.80- 需要全局视图: 是- 需要关系路径追踪: 是- 包含时间相关内容: 否- 涉及知识领域: 教育政策, 奖学金评选标准, 学生纪律条例这个问题的核心是评选国家奖学金的条件和小明同学的行为是否符合这些条件。为了回答这个问题，我们需要了解以下信息：1.**国家奖学金的评选条件和标准**：通常来说，国家奖学金的评选标准包括学术成绩、道德品行、社会表现、综合素质等多个方面。具体的标准会因国家和具体的教育机构而异，但通常会有对品行和纪律的要求。2.**小明同学的行为影响**：旷课、私藏违禁物品和殴打同学这几种行为在一般的学校纪律和道德评定中都是负面的，会对小明的评选资格产生影响。然而具体的影响程度以及是否绝对排除他获得奖学金的资格要视具体的学校规定和情况而定。...**执行任务 1/7**: local_search - 学校的旷课处分条款✓ 本地搜索完成**执行任务 2/7**: local_search - 学校关于私藏危险物品的处罚规定✓ 本地搜索完成**执行任务 3/7**: local_search - 学校对于教师、学生的纪律处罚规定✓ 本地搜索完成**执行任务 4/7**: local_search - 学校对于学生暴力行为的处分规定✓ 本地搜索完成**执行任务 5/7**: global_search - 国家奖学金评选标准✓ 全局搜索完成**执行任务 6/7**: chain_exploration - 评选标准中对于纪律违反的具体要求**开始Chain of Exploration**...- 从已有结果中提取实体: 国家奖学金, 学校纪律规定- 探索路径:  • 步骤0: 国家奖学金  • 步骤0: 学校纪律规定  • 步骤1: 奖学金评审原则  • 步骤1: 评审委员会  • 步骤1: 学生学籍档案- 找到 21 条相关内容✓ Chain of Exploration完成**执行任务 7/7**: exploration - 学校对旷课、私藏物品、暴力行为的综合处理情况**开始深度探索**...✓ 深度探索完成**正在基于所有搜索结果进行最终思考**...基于提供的验证结果汇总，我们可以看到所有假设均未被支持、拒绝或标记为不确定。这种情况下，我们缺乏具体数据来支持或反对任何假设。对于这种情境，我的更新的思考过程是：1.**缺乏数据支持：** 在当前验证结果中，没有任何假设得到了明确的支持、拒绝或不确定的标记，这意味着我们缺乏足够的数据或证据来进行进一步的分析和得出结论。2.**继续收集数据：** 由于目前没有确定性的结果，建议加强数据的收集和分析，以便为每个假设提供更强的证据支撑。这包括设计新的实验、寻找额外的数据来源、增加样本数量等。...**正在整合所有检索结果，生成最终答案**...**正在整合所有检索结果，生成最终答案**...根据检索结果，回答小明同学是否能够评选国家奖学金的问题，需考虑其行为对奖学金评选条件的影响。以下是分析：### 一、国家奖学金评选条件国家奖学金评定标准不仅强调学习成绩优秀（例如排名前10%），还要求申请者具备高尚的道德品行，表现出色，例如参与社会服务或遵守宪法和法律。这些要求显示道德品行和纪律表现是评选的重要考量因素。### 二、行为分析与影响#### 1. **旷课行为**根据学校纪律处分规定，旷课是严重违纪行为。未请假擅自不参加课程超过一定学时可导致警告、记过或更严重的处分。因此，旷课30学时对奖学金评选可能产生较大的负面影响。#### 2. **私藏危险物品**学校对私藏危险物品，如违反使用电器的行为，有明确的处分措施，可能以警告或记过处分。此行为不仅影响个人安全，也被认为是违反学校规章制度的行为。#### 3. **暴力行为**暴力行为如殴打同学通常会被严重处理，可能导致记过或留校察看处分。在奖学金评选中，被记录的暴力行为会显著影响学生道德品行的评估。### 三、综合分析与结论由于国家奖学金评选要求申请者无严重违纪行为，小明同学的多项违规包括旷课、私藏危险物品和暴力行为，均会严重影响其道德品行评价。因此，按照通常的评选标准，小明同学不符合“无违纪记录”的条件，这将直接剥夺他评选国家奖学金的资格。基于以上分析，小明因多种违纪行为无法评选国家奖学金。建议小明思考自身行为带来的后果，并在未来更加遵守学校规定，积极改善自己的表现。### 信息来源- 学校的学籍管理条例和纪律处分规定内容。- 国家奖学金的评选标准，包括道德品行考核。===== 测试总结=====成功测试: 4/4平均总耗时: 289.21秒平均首块延迟: 1.03秒平均数据块数: 20.0个测试完成: 2025-04-05 22:14:29

网页端演示

🔮 未来规划

🙏 参考与致谢

Star History