[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"$frR2MAyN8HNpNnzP3MWvlcO9TNFka-He5iSKIZhDDh6E":3,"ad-slot-floating-promo":28,"ad-slot-course-detail-side":31},{"id":4,"name":5,"icon":6,"description":7,"category":8,"price":9,"originalPrice":10,"creditCost":11,"content":12,"resources":13,"status":19,"tags":20,"type":26,"url":27,"orders":11},118,"AI Agentic RAG高级企业知识库平台","knowledge","基于企业知识库、PGVector 向量检索、Agentic RAG、FastAPI + LangGraph、Function Calling，实现向量 + BM25 混合检索与 RRF 融合、Rerank 重排、HyDE 与多查询改写、父子分块召回、LangGraph 状态图自适应检索、Agent 执行时间线和 LLM-as-judge 四指标评测，覆盖从基础 RAG 到高级 RAG 调优的完整闭环。","AI_PROJECT",18900,39900,0,"\u003Ch2>一、项目技术栈\u003C\u002Fh2>\n\u003Cp>前后端分离\u003C\u002Fp>\n\u003Cp>\u003Cstrong>后端\u003C\u002Fstrong>：FastAPI + Uvicorn + Tortoise ORM（异步）+ LangChain + LangGraph + PyJWT + sse-starlette（Python 3.11）\u003Cbr>\u003Cstrong>前端\u003C\u002Fstrong>：Vue3 + Vite + Element-Plus + Vue-Router + Axios + ECharts（SSE 流式问答、召回结果对比、评测柱状图、Agent 执行时间线）\u003Cbr>\u003Cstrong>AI 技术\u003C\u002Fstrong>：混合检索（向量 + BM25 + RRF 融合）+ Rerank 重排 + 查询改写（多查询扩展 \u002F 指代消解 \u002F HyDE）+ 父子分块与父块回填 + 元数据过滤 + Agentic RAG（LangGraph 状态图自主决策）+ Function Calling 工具中心 + 多轮流式问答 + LLM-as-judge 四指标评测\u003Cbr>\u003Cstrong>文档处理\u003C\u002Fstrong>：PyMuPDF + pdfplumber（PDF 与表格）+ python-docx + openpyxl + RapidOCR（扫描件识别，纯 CPU）+ jieba（中文分词）\u003Cbr>\u003Cstrong>数据库\u003C\u002Fstrong>：MySQL（业务库）+ PostgreSQL 18 & PGVector（向量库）  \u003C\u002Fp>\n\u003Cp>模型全部使用阿里云百炼，在管理端配置，改配置立刻生效不用重启：\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">对话模型  qwen-plus            OpenAI 兼容接口\n向量模型  \u003Cspan class=\"hljs-selector-tag\">text\u003C\u002Fspan>-embedding-v4    OpenAI 兼容接口，\u003Cspan class=\"hljs-number\">1024\u003C\u002Fspan> 维\n重排模型  gte-rerank-v2        DashScope 原生接口（自写 LangChain 重排组件）\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp>版本要求：\nPython 不低于 3.11，MySQL 8，PostgreSQL 16 及以上并安装 PGVector 扩展，node.js 版本 18 以上，navicat 建议不低于 16\u003C\u002Fp>\n\u003Ch2>二、项目功能描述\u003C\u002Fh2>\n\u003Ch3>1. 管理员\u003C\u002Fh3>\n\u003Cp>登录、个人资料、修改密码\n用户管理：管理系统所有用户\u003C\u002Fp>\n\u003Cp>\u003Cstrong>知识库管理\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp>知识库管理：企业资料的一级分类，绑定向量模型与切分策略\u003Cbr>切分策略：维护递归分块与父子分块两类策略及其参数\u003Cbr>检索策略：维护七个检索开关（向量、BM25、RRF、重排、查询改写、父块回填、两档阈值）\u003Cbr>文档管理：上传 PDF \u002F Word \u002F Excel \u002F Markdown \u002F TXT，解析、切分、向量化\u003Cbr>片段管理：查看与人工修正切歪了的片段\u003Cbr>检索测试：输入一个问题，看这套策略每一阶段召回了多少条、耗时多久、分数是什么量纲\u003Cbr>召回调试台：同一个问题最多四套策略并排跑，结果与耗时摆在一起对比  \u003C\u002Fp>\n\u003Cp>\u003Cstrong>AI 配置\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp>AI模型配置：三类模型的接入配置与连通性测试\u003Cbr>Prompt模板：所有发给模型的提示词在页面维护，改完立刻生效\u003Cbr>工具中心：登记 Agent 可调用的工具，启用开关是真开关\u003Cbr>工具调用日志：查看每次工具调用的入参、返回与耗时\u003Cbr>Agent执行：手动触发一次 Agentic RAG，观察模型自主决策的全过程\u003Cbr>Agent运行记录：查看 Agent Run 与 Agent Step，执行过程时间线可视化\u003C\u002Fp>\n\u003Cp>\u003Cstrong>问答应用\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp>应用管理：配置问答应用绑定的知识库、检索策略与回答 Prompt\u003Cbr>问答测试：管理端直接测试问答效果\u003Cbr>对话日志与反馈：查看完整对话记录，用户点踩的问题进入优化清单  \u003C\u002Fp>\n\u003Cp>\u003Cstrong>效果评测\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp>评测集管理：手工录入、从文档自动生成、从点踩沉淀三种方式维护评测用例，支持核对来源片段原文\u003Cbr>批量评测：选定评测集与检索策略跑一轮，用 LLM-as-judge 给出四项指标\u003Cbr>策略对比看板：多份报告并排，柱状图横向对比每一步优化带来的分数变化\u003C\u002Fp>\n\u003Ch3>2. 用户\u003C\u002Fh3>\n\u003Cp>登录、注册、个人资料、修改密码、头像上传\u003Cbr>AI 知识问答：选择问答应用后用自然语言提问，答案 SSE 流式逐字返回\u003Cbr>引用溯源：每条回答下方列出引用的知识片段，可展开查看原文与来源文档\u003Cbr>多轮对话：同一会话内追问，"那它呢"这类指代由系统自动补全成完整问题\u003Cbr>会话管理：新建、切换、删除历史会话\u003Cbr>点赞点踩：对回答做反馈，点踩可填写原因\u003C\u002Fp>\n\u003Ch2>三、项目创新点\u003C\u002Fh2>\n\u003Col>\n\u003Cli>\u003Cp>\u003Cstrong>混合检索 + RRF 融合解决"专有名词检索不到"\u003C\u002Fstrong>：向量检索认识同义词但认不出 \u003Ccode>GTE-3000\u003C\u002Fcode> 这类精确型号，BM25 认得型号却听不懂同义表达，两路一起跑再用 RRF 按名次融合。融合不能直接加分数——向量给的是 0~1 的余弦相似度，BM25 没有上界，两者量纲不同，RRF 只看名次不看分数正是为此设计。中文分词还额外把 \u003Ccode>GTE3000\u003C\u002Fcode> 拆出 \u003Ccode>gte\u003C\u002Fcode> 和 \u003Ccode>3000\u003C\u002Fcode>，否则文档里写 \u003Ccode>GTE-3000\u003C\u002Fcode> 时两边一个词都对不上。\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>\u003Cstrong>自写 LangChain 重排组件解决"答案召回了却排在后面"\u003C\u002Fstrong>：真正写着答案的那一段被检索出来了，但排在后面，前面全是"看着很相关、其实没回答问题"的内容——模型对中间段落的注意力最低，很容易被前面几段带偏，输出一段听起来像样、实际答非所问的话。根子在于向量检索是双塔模型，问题和片段分开编码，存片段时并不知道用户会问什么，只能判断"整体像不像"，判断不了"这段能不能回答这个问题"。重排把问题和片段拼在一起送进模型做交叉编码，准得多但慢，只能用在粗筛之后。百炼的重排接口不在 OpenAI 兼容模式下，因此把它包装成 LangChain 的 \u003Ccode>BaseDocumentCompressor\u003C\u002Fcode>，作为标准组件接进检索链路。\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>\u003Cstrong>分数量纲显式化，阈值按量纲分开配\u003C\u002Fstrong>：\u003Ccode>score\u003C\u002Fcode> 这一个字段在管线里被反复覆盖，每覆盖一次量纲就换一次——余弦相似度（相关片段实测 0.46\u003Cdel>0.77）、BM25 分数（无上界）、RRF 名次分（0.016\u003C\u002Fdel>0.033）、重排相关分（相关片段实测 0.14~0.20）。四种量纲取值范围差一个数量级，用同一个阈值去卡会把结果整片砍掉。所以量纲作为显式信息跟着结果一路传下去，策略表里给余弦相似度和重排相关分各配一个阈值，RRF 名次分只表示名次先后、不做阈值过滤且在页面上明确标注"本次不适用"。\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>\u003Cstrong>父子分块解决"找得准"与"答得全"的矛盾\u003C\u002Fstrong>：片段小则语义集中命中准、但上下文不全；片段大则上下文完整、但一段混多个主题难命中。两个要求对尺寸的需求是反的，于是切两遍：只把子块向量化参与检索，命中后回填整个父块给模型生成——小块用来找，大块用来答。\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>\u003Cstrong>Agentic RAG：调用次数由模型决定，而不是写死在代码里\u003C\u002Fstrong>：用 LangGraph 把"检索 → 评估 → 改写 → 再检索 → 生成 → 自查"编成状态图，\u003Cstrong>检索几轮、改写几次、答案不合格要不要重来，全由模型每一轮的判断决定\u003C\u002Fstrong>，代码只设循环上限。同一个问题问两次，走出来的步数和检索次数可能完全不同，这是 Agent 与固定流程编排的本质区别。这套 Agent 的自主性不在「调哪个工具」而在「自己的产出够不够好」，状态图上只用检索一个工具，属于 Agentic RAG（Self-RAG \u002F CRAG 一系）范式，其中「答案没支撑就回去重写」一环是 Reflection 的简化形态。\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>\u003Cstrong>执行过程全程落库，自主决策可复盘\u003C\u002Fstrong>：模型自主决策的副作用是过程像黑盒，所以每一步都落成 \u003Ccode>agent_step\u003C\u002Fcode>（节点名、输入、输出、状态、耗时），配合 \u003Ccode>agent_run\u003C\u002Fcode> 主记录和前端执行时间线，能完整回放"这一次模型为什么这样答"。\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>\u003Cstrong>实现 LLM-as-judge 四指标\u003C\u002Fstrong>：Context Recall 看该找的资料找回来没有、Context Precision 看有用的资料排在前面没有、Faithfulness 看答案有没有编、Answer Relevancy 看有没有跑题。四个指标把 RAG 拆成"找资料"和"写答案"两段各测两项，分数低时先看它属于哪一段，就知道该去调检索策略还是调 Prompt。裁判模型 temperature 必须为 0，否则两次评测的差异分不清是策略变了还是裁判抖了。\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>\u003Cstrong>评测用例带来源片段，Context Recall 不靠模型判断\u003C\u002Fstrong>：从文档自动生成用例时，要求模型逐条标出答案来自哪一个片段，这个片段 ID 回写到用例上。算 Context Recall 时直接做集合运算，比让模型判断更准也更省钱。参照必须精确到单条——记成整篇文档的全部片段会把分母撑大，答案明明只在一段里却要求整篇都召回才算满分，\u003Ccode>top_k=5\u003C\u002Fcode>、文档 9 段时理论上限只有 5\u002F9，这个指标就废了。\u003C\u002Fp>\n\u003C\u002Fli>\n\u003Cli>\u003Cp>\u003Cstrong>优化效果用数据证明，不靠"我觉得变好了"\u003C\u002Fstrong>：同一套评测集换不同检索策略反复跑，报告并排进对比看板。实测同一批用例：基线纯向量检索综合 0.7988，完整策略（混合检索 + 重排 + 改写 + 父块回填）0.9616，其中一条问题在基线下召回排第 12 位拿不到、重排后被顶到第 1 位。前面所有检索优化的价值，就落在这张对比图上。\u003C\u002Fp>\n\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch2>四、项目规模\u003C\u002Fh2>\n\u003Cpre>\u003Ccode class=\"language-text\">MySQL 25 张业务表 + PGVector 1 张向量表\n教程文档 31 章 + 3 个附件\n后端 Python 模块 67 个，自动化测试 196 条\n前端 Vue 页面 30 个\u003C\u002Fcode>\u003C\u002Fpre>\u003Ch2>五、关键页面截图\u003C\u002Fh2>\n\u003Cp>（坐等武哥更新）\u003C\u002Fp>\n",[14,15,16,17,18],"源码+SQL","喂饭学习教程","配套面试文档","环境安装文档","项目运行文档","上架",[21,22,23,24,25],"FastAPI","LangChain","LangGraph","RAG","PGVector","地狱锤炼",null,{"data":29,"_fetchedAt":30},[],1788748986491,{"data":32,"_fetchedAt":33},[],1788748986494]