基于 LangGraph 的 Agentic RAG 核心架构

news2026/4/6 0:08:29
核心摘要当资深运维专家离场留下的往往不仅是空荡荡的工位更是无数无法被Wiki捕捉的“隐性知识”。本文将摒弃空洞的概念炒作基于Agentic RAG架构利用LangGraph与Qwen2.5从零构建一个具备“反思-迭代”能力的“火电运维专家Agent”。这不仅是一份代码实录更是企业核心经验实现数字永生的技术宣言。1. 逝去的“老法师”与沉默的知识断层在火电厂的集控室里最可怕的不是报警灯的闪烁而是当那个总是端着茶杯的“老张”离开后面对同样的故障报警一群硕博工程师却面面相觑。隐性知识——那些写在故障处理规程之外的经验、直觉和手速——往往随着人员的流动而彻底消失。传统的企业Wiki或静态知识库Confluence, SharePoint只能存储“显性知识”即已经被文档化的信息。而真正的运维核心往往存在于“汽温波动与煤质特性的非线性关系”这种即时的判断中。同事被优化了但他的经验必须留下。我们需要构建的不仅仅是一个问答机器人而是一个能够模拟专家思维链的Agent智能体。它不应只是简单的检索增强生成RAG而必须是具备Agentic代理特性的能够规划、执行、反思和纠错。2. 技术选型拒绝玩具级架构市面上大多数“知识库搭建”教程仅停留在“文档切片 - 向量化 - 召回”的初级阶段。这种线性流程在工业场景下是致命的——一旦召回的上下文偏差大模型LLM极易产生幻觉误导运维人员导致停机事故。为此我们确立了基于LangGraph的Agentic RAG架构并选用了Qwen2.5-72B-Instruct作为基座模型。2.1 核心组件选型逻辑组件选型方案选型理由 (工业级考量)替代方案对比基座模型Qwen2.5-72B1.中文理解力在CMMLU榜单上对中文工业术语理解极佳。2.Tool Calling原生支持Function Calling格式稳定。3.长文本支持128k上下文足以吞下整份《锅炉运行规程》。Llama 3.1 (中文逻辑略弱)GPT-4o (私有化部署成本高/合规风险)向量数据库Milvus 2.41.Hybrid Search支持稀疏稠密向量混合检索精准匹配设备编号。2.标量过滤支持按“机组编号”、“时间”等元数据精准过滤。Pinecone (SaaS不可控)FAISS (无元数据过滤不适合生产)编排框架LangGraph1.循环图原生支持“反思-重试”的循环逻辑而非LangChain的DAG。2.Stateful维护对话状态适合多轮故障排查。LangChain Chain (线性死板无法回头)Rerank模型BGE-Reranker-v2-m3在召回后进行精细排序解决“语义相似但逻辑相反”的问题如“开启阀门”vs“禁止开启阀门”。无Rerank (准确率下降20%)3. 架构设计构建“会思考”的闭环传统的RAG是“一锤子买卖”问一次查一次答一次。而我们的目标是模拟人类专家的思维过程分析问题是设备故障还是操作失误查阅资料先看规程再看历史工单。自我评估找到的信息够吗能不能解释通生成答案给出带有置信度的操作建议。以下是基于 LangGraph 的 Agentic RAG 核心架构图工具层 Tools1. 检索规程2. 查历史Re-PlanRewrite用户输入:3号炉汽温异常Qwen2.5 Agent推理与规划向量检索Milvus Hybrid Search关系型查询历史故障工单实时搜索外部技术论坛上下文构建s10答案生成器Answer Generators11最终输出带引用来源4. 硬核实战代码实现环境准备确保你已经部署了 Milvus 和 Ollama (或 vLLM) 服务。开源依赖langchain,langgraph,pymilvus,langchain-community4.1 定义状态与工具首先我们需要定义 Agent 的“大脑”状态。在 LangGraph 中State 是在节点间流转的记忆。fromtypingimportTypedDict,Annotated,List,Unionfromlangchain_core.messagesimportHumanMessage,AIMessage,SystemMessageimportoperator# 定义Agent的状态messages会自动累加classAgentState(TypedDict):messages:Annotated[list,operator.add]# 对话历史query:str# 用户原始问题context:List[str]# 检索到的上下文confidence:float# 置信度评分iterations:int# 迭代次数防止死循环# 模拟连接 Milvus 进行混合检索defsearch_fault_records(query:str,unit_id:str3): 在向量库中检索故障记录和运行规程。 实际生产中应使用 Milvus Client 进行 search。 # 伪代码演示这里应当是 collection.search(...)print(f- [Tool Call] 正在检索机组{unit_id}关于 {query} 的记录...)# 模拟返回的文档片段docs[《锅炉运行规程 4.2.1》当主汽温度超过额定值5℃时应立即检查减温水门开度。,历史工单 #2023-11023号炉发生过热器爆管前兆为减温水流量异常波动。]returndocs# 模拟查询结构化数据如D CS历史数据库defquery_dcs_data(parameter:str):print(f- [Tool Call] 正在查询 DCS 实时数据:{parameter}...)returnf当前{parameter}数值为 545℃ (报警限 540℃)4.2 构建核心节点评估与反思这是区分“玩具”和“专家”的关键。如果检索到的信息是垃圾Agent 必须有能力拒绝回答并重新检索。fromlangchain_openaiimportChatOpenAIfromlangchain_core.promptsimportChatPromptTemplate# 假设我们使用本地部署的 Qwen2.5 接口llmChatOpenAI(base_urlhttp://localhost:8000/v1,modelQwen2.5-72B-Instruct,api_keyempty)# 节点检索defretrieve_node(state:AgentState):querystate[query]# 实际这里应该由LLM提取参数docssearch_fault_records(query)return{context:docs}# 节点评估 - 决定是否需要重新检索或利用外部工具defgrade_documents_node(state:AgentState): 使用LLM作为评判官判断检索到的上下文是否足以回答问题。 print(-- [Node] 正在评估文档相关性...)questionstate[query]documentsstate[context]promptChatPromptTemplate.from_messages([(system,你是一个严谨的火电运维专家助手。请判断以下文档片段是否包含回答用户问题所需的关键信息。),(user,问题: {question}\n\n文档片段: {docs}\n\n如果信息足够回复 YES否则回复 NO。)])chainprompt|llm responsechain.invoke({question:question,docs:\n.join(documents)})ifYESinresponse.content:return{confidence:0.9}# 足够高可以生成else:print(-- [Warning] 文档相关性不足准备触发重试机制...)return{confidence:0.3,iterations:state[iterations]1}# 节点生成答案defgenerate_node(state:AgentState):print(-- [Node] 正在生成最终回答...)# 调用LLM生成包含 System Prompt 防止幻觉pass4.3 编排 LangGraph让逻辑闭环这是最激动人心的部分。我们将定义图的边实现“如果不满意就重来”的逻辑。fromlanggraph.graphimportStateGraph,END workflowStateGraph(AgentState)# 1. 添加节点workflow.add_node(retrieve,retrieve_node)workflow.add_node(grade,grade_documents_node)workflow.add_node(generate,generate_node)# 2. 设置入口workflow.set_entry_point(retrieve)# 3. 添加边workflow.add_edge(retrieve,grade)# 4. 添加条件边 - 核心逻辑defdecide_to_generate(state:AgentState):# 如果迭代次数超过3次强制退出避免死循环ifstate[iterations]3:returnabortifstate[confidence]0.7:returngenerateelse:# 这里可以加入改写Query的逻辑为了演示简洁直接重试returnretry# 从 grade 节点出来根据条件决定去向workflow.add_conditional_edges(grade,decide_to_generate,{generate:generate,retry:retrieve,# 置信度不够回头重新检索abort:END})workflow.add_edge(generate,END)# 5. 编译图appworkflow.compile()5. 实战演练一个复杂的故障排查 Case为了验证效果我们模拟一个复杂的输入。用户并没有直接说“故障”而是描述了现象。输入“3号机组的给水流量突然掉了10%但负荷没变主汽压力还在涨这是什么鬼”Agent 运行日志模拟[Agent Reasoning]分析问题关键词给水流量,负荷,主汽压力。初步判断可能是给水泵故障或阀门误关。[Tool Call]search_fault_records(给水流量下降 主汽压力上升)。[Retrieval]召回文档《给水系统故障处理》。[Evaluation]文档只提到了泵跳闸但用户说负荷没变置信度评分0.4 (FAIL)。[Re-Plan]Agent 决定改写查询词增加负荷不变条件并查询历史工单。[Tool Call]search_fault_records(给水流量下降 负荷不变)ANDquery_dcs_data(主汽压力)。[Retrieval]召回工单 #2021-0405“高压旁路阀误开导致虚假水位及流量异常”。[Evaluation]逻辑自洽置信度0.85 (PASS)。[Generation]“根据《高压旁路运行导则》及历史工单 #2021-0405建议立即检查高压旁路阀状态。虽然给水流量显示下降但主汽压力上升且负荷不变极有可能是旁路阀误开导致蒸汽短路引起给水测量偏差。请就地核对旁路阀位。”效果分析普通的 RAG 在第 3 步就会基于“给水流量”检索到“检查给水泵”的错误建议导致运维人员走弯路。而Agentic RAG通过第 5 步的“反思-重试”成功定位了更深层的逻辑关联。6. 总结与展望经验的各种数字永生我们刚刚做的不仅仅是写了一个 Python 脚本而是完成了一次知识建模。从数据层面我们将非结构化的规程、离散的工单通过向量化和图谱技术变成了机器可理解的“记忆”。从逻辑层面我们通过Evaluator和Re-plan赋予了 AI “怀疑精神”。在“同事被优化”的叙事背景下这套系统的价值显得尤为残酷而珍贵。当一个拥有 20 年经验的老师傅离开他留下的不仅是几本手写笔记更是一个能够 24 小时秒回、不知疲倦、且能随着新数据不断自我进化的数字分身。这才是技术对人类经验最大的尊重。附录参考资源与延伸阅读LangGraph Documentation: https://langchain-ai.github.io/langgraph/ (构建循环Agent的最佳框架)Qwen2.5 Technical Report: https://arxiv.org/abs/2309.16609 (通义千问开源模型国产之光)Milvus Hybrid Search: https://milvus.io/docs/hybridsearch.md (多路召回的关键)BGE Re-ranker Model: https://huggingface.co/BAAI/bge-reranker-v2-m3 (提升检索精度的神器)

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/2487288.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

SpringBoot-17-MyBatis动态SQL标签之常用标签

文章目录 1 代码1.1 实体User.java1.2 接口UserMapper.java1.3 映射UserMapper.xml1.3.1 标签if1.3.2 标签if和where1.3.3 标签choose和when和otherwise1.4 UserController.java2 常用动态SQL标签2.1 标签set2.1.1 UserMapper.java2.1.2 UserMapper.xml2.1.3 UserController.ja…

wordpress后台更新后 前端没变化的解决方法

使用siteground主机的wordpress网站,会出现更新了网站内容和修改了php模板文件、js文件、css文件、图片文件后,网站没有变化的情况。 不熟悉siteground主机的新手,遇到这个问题,就很抓狂,明明是哪都没操作错误&#x…

网络编程(Modbus进阶)

思维导图 Modbus RTU(先学一点理论) 概念 Modbus RTU 是工业自动化领域 最广泛应用的串行通信协议,由 Modicon 公司(现施耐德电气)于 1979 年推出。它以 高效率、强健性、易实现的特点成为工业控制系统的通信标准。 包…

UE5 学习系列(二)用户操作界面及介绍

这篇博客是 UE5 学习系列博客的第二篇,在第一篇的基础上展开这篇内容。博客参考的 B 站视频资料和第一篇的链接如下: 【Note】:如果你已经完成安装等操作,可以只执行第一篇博客中 2. 新建一个空白游戏项目 章节操作,重…

IDEA运行Tomcat出现乱码问题解决汇总

最近正值期末周,有很多同学在写期末Java web作业时,运行tomcat出现乱码问题,经过多次解决与研究,我做了如下整理: 原因: IDEA本身编码与tomcat的编码与Windows编码不同导致,Windows 系统控制台…

利用最小二乘法找圆心和半径

#include <iostream> #include <vector> #include <cmath> #include <Eigen/Dense> // 需安装Eigen库用于矩阵运算 // 定义点结构 struct Point { double x, y; Point(double x_, double y_) : x(x_), y(y_) {} }; // 最小二乘法求圆心和半径 …

使用docker在3台服务器上搭建基于redis 6.x的一主两从三台均是哨兵模式

一、环境及版本说明 如果服务器已经安装了docker,则忽略此步骤,如果没有安装,则可以按照一下方式安装: 1. 在线安装(有互联网环境): 请看我这篇文章 传送阵>> 点我查看 2. 离线安装(内网环境):请看我这篇文章 传送阵>> 点我查看 说明&#xff1a;假设每台服务器已…

XML Group端口详解

在XML数据映射过程中&#xff0c;经常需要对数据进行分组聚合操作。例如&#xff0c;当处理包含多个物料明细的XML文件时&#xff0c;可能需要将相同物料号的明细归为一组&#xff0c;或对相同物料号的数量进行求和计算。传统实现方式通常需要编写脚本代码&#xff0c;增加了开…

LBE-LEX系列工业语音播放器|预警播报器|喇叭蜂鸣器的上位机配置操作说明

LBE-LEX系列工业语音播放器|预警播报器|喇叭蜂鸣器专为工业环境精心打造&#xff0c;完美适配AGV和无人叉车。同时&#xff0c;集成以太网与语音合成技术&#xff0c;为各类高级系统&#xff08;如MES、调度系统、库位管理、立库等&#xff09;提供高效便捷的语音交互体验。 L…

(LeetCode 每日一题) 3442. 奇偶频次间的最大差值 I (哈希、字符串)

题目&#xff1a;3442. 奇偶频次间的最大差值 I 思路 &#xff1a;哈希&#xff0c;时间复杂度0(n)。 用哈希表来记录每个字符串中字符的分布情况&#xff0c;哈希表这里用数组即可实现。 C版本&#xff1a; class Solution { public:int maxDifference(string s) {int a[26]…

【大模型RAG】拍照搜题技术架构速览:三层管道、两级检索、兜底大模型

摘要 拍照搜题系统采用“三层管道&#xff08;多模态 OCR → 语义检索 → 答案渲染&#xff09;、两级检索&#xff08;倒排 BM25 向量 HNSW&#xff09;并以大语言模型兜底”的整体框架&#xff1a; 多模态 OCR 层 将题目图片经过超分、去噪、倾斜校正后&#xff0c;分别用…

【Axure高保真原型】引导弹窗

今天和大家中分享引导弹窗的原型模板&#xff0c;载入页面后&#xff0c;会显示引导弹窗&#xff0c;适用于引导用户使用页面&#xff0c;点击完成后&#xff0c;会显示下一个引导弹窗&#xff0c;直至最后一个引导弹窗完成后进入首页。具体效果可以点击下方视频观看或打开下方…

接口测试中缓存处理策略

在接口测试中&#xff0c;缓存处理策略是一个关键环节&#xff0c;直接影响测试结果的准确性和可靠性。合理的缓存处理策略能够确保测试环境的一致性&#xff0c;避免因缓存数据导致的测试偏差。以下是接口测试中常见的缓存处理策略及其详细说明&#xff1a; 一、缓存处理的核…

龙虎榜——20250610

上证指数放量收阴线&#xff0c;个股多数下跌&#xff0c;盘中受消息影响大幅波动。 深证指数放量收阴线形成顶分型&#xff0c;指数短线有调整的需求&#xff0c;大概需要一两天。 2025年6月10日龙虎榜行业方向分析 1. 金融科技 代表标的&#xff1a;御银股份、雄帝科技 驱动…

观成科技:隐蔽隧道工具Ligolo-ng加密流量分析

1.工具介绍 Ligolo-ng是一款由go编写的高效隧道工具&#xff0c;该工具基于TUN接口实现其功能&#xff0c;利用反向TCP/TLS连接建立一条隐蔽的通信信道&#xff0c;支持使用Let’s Encrypt自动生成证书。Ligolo-ng的通信隐蔽性体现在其支持多种连接方式&#xff0c;适应复杂网…

铭豹扩展坞 USB转网口 突然无法识别解决方法

当 USB 转网口扩展坞在一台笔记本上无法识别,但在其他电脑上正常工作时,问题通常出在笔记本自身或其与扩展坞的兼容性上。以下是系统化的定位思路和排查步骤,帮助你快速找到故障原因: 背景: 一个M-pard(铭豹)扩展坞的网卡突然无法识别了,扩展出来的三个USB接口正常。…

未来机器人的大脑:如何用神经网络模拟器实现更智能的决策?

编辑&#xff1a;陈萍萍的公主一点人工一点智能 未来机器人的大脑&#xff1a;如何用神经网络模拟器实现更智能的决策&#xff1f;RWM通过双自回归机制有效解决了复合误差、部分可观测性和随机动力学等关键挑战&#xff0c;在不依赖领域特定归纳偏见的条件下实现了卓越的预测准…

Linux应用开发之网络套接字编程(实例篇)

服务端与客户端单连接 服务端代码 #include <sys/socket.h> #include <sys/types.h> #include <netinet/in.h> #include <stdio.h> #include <stdlib.h> #include <string.h> #include <arpa/inet.h> #include <pthread.h> …

华为云AI开发平台ModelArts

华为云ModelArts&#xff1a;重塑AI开发流程的“智能引擎”与“创新加速器”&#xff01; 在人工智能浪潮席卷全球的2025年&#xff0c;企业拥抱AI的意愿空前高涨&#xff0c;但技术门槛高、流程复杂、资源投入巨大的现实&#xff0c;却让许多创新构想止步于实验室。数据科学家…

深度学习在微纳光子学中的应用

深度学习在微纳光子学中的主要应用方向 深度学习与微纳光子学的结合主要集中在以下几个方向&#xff1a; 逆向设计 通过神经网络快速预测微纳结构的光学响应&#xff0c;替代传统耗时的数值模拟方法。例如设计超表面、光子晶体等结构。 特征提取与优化 从复杂的光学数据中自…