langgraph graphrag agents checkpointing rag

LangGraph控制平面与知识图谱：能够承受接触的构建顺序

将LangGraph的控制流图与知识图谱分开，设置人工中断检查点，并且仅在检测到多跳RAG失败时才添加GraphRAG。

发布者：REACTAPP.TOP加入本站 2026年9月26日阅读约 18 分钟4078 词

控制流图与知识图谱仅共享一个概念，除此之外几乎毫无相似之处。本指南将二者区分开来，说明在何种情况下LangGraph风格的状态机能够发挥作用，以及何时应让GraphRAG风格的数据图在经历多次跳转失败后才能被使用。

首先避免构建成本高昂的图结构

仅仅因为知识图谱听起来更先进就直接采用，其实是在重复一个常见错误。那些用于评估简单查询的基准测试往往显示，普通文本块与图检索的效果相当——却要付出构建图的额外成本而得不到任何优势。应先从用于控制的架构图开始，只有在向量搜索在处理关系类问题时失败后，再添加数据图。

基于图的智能体究竟是什么

代理图是一种状态机：节点负责更新共享状态，边则决定下一个节点，中断用于暂停供人类操作，检查点则能在崩溃后保留数据。它描述的是执行流程的推进方式，而非事实存储的位置。

值得记住的五种模式

路由器→专用工具；规划器→执行器；人工审批节点；子任务上的映射归约；循环的“不断优化直至完成”结构。每种模式都是明确的边策略，而非隐藏的if嵌套结构。

具体机制

from langgraph.graph import StateGraph, START, END
from typing_extensions import TypedDict

共享状态表现为带类型的字典：

class State(TypedDict):
    query: str
    docs: list
    answer: strdef retrieve(state: State):
    return {"docs": kg_search(state["query"])}   # a retrieval nodedef generate(state: State):
    return {"answer": llm(state["query"], state["docs"])}g = (StateGraph(State)
     .add_node("retrieve", retrieve)
     .add_node("generate", generate)
     .add_edge(START, "retrieve")
     .add_edge("retrieve", "generate")
     .add_edge("generate", END)
     .compile())

中断会在图执行过程中暂停：

from langgraph.types import interrupt, Command

审批节点示例：

def approval(state):
    ok = interrupt({"question": "Approve?", "amount": state["amount"]})
    return {"status": "approved" if ok else "rejected"}

ASCII控制流：

+-----------+
START --> |  router   |
          +-----------+
           |         |
   (relational)   (simple)
           v         v
      +---------+  +--------+
      | graph   |  | vector |
      | retrieve|  |retrieve|
      +---------+  +--------+
            \         /
             v       v
          +-------------+       +--------------+
          |  reason /   |----> | write-memory |--> KG
          |  generate   |       +--------------+
          +-------------+
                |
         (needs approval?) --> interrupt() --> human
                |
                v
               END

检查点机制本身并非持久化执行

将状态持久化到 SQLite 或 Postgres 中可以防止重启后工单丢失。它并非具备计时器和队列功能的完整工作流引擎——但若没有这些功能，依赖人工干预的演示就无法真实反映其投入生产的能力。

另一种类型的图结构

知识图谱存储从语料库中提取的实体与边关系。它们有助于处理多跳的所有权关联及影响分析问题；但在回答“X是什么”这类查询时，它们并不一定比 BM25+向量算法更优。

演示文稿中省略的基准测试

当简单的事实查询可以通过文本片段与图结构方法相互关联时，就需要通过不同的问题组合来证明其复杂性存在的合理性。此外，在修正了大型语言模型评估者的偏差后，胜率会大幅下降，这也是必须在自有流量上进行测试的另一个原因。

混合方案究竟能带来什么

密集的词汇锚点与可选的图结构锚点相结合，并通过互惠排名融合技术，能够覆盖同义表达及标识符。图遍历操作位于标识符锚点之后，而非每个查询之前。

成本考量

多智能体架构相比单次对话大约会消耗高一个数量级的标记数。若不衡量成本差异就直接在原有架构上叠加GraphRAG提取功能，就会导致费用激增，而查询服务的质量却保持不变。

具备时间感知能力的记忆系统

对话状态检查点不同于长期偏好存储以及CDN风格的响应缓存。将它们混用会导致机器人在中途忘记用户姓名或提供过时的策略。

2026年的技术架构：客观评价

使用LangGraph进行控制，对于大多数检索场景采用经过验证的向量/混合存储方式，仅在关系本身才是关键答案时才使用具备本体认知能力的图结构。对标记使用情况的可观测性以及优先级处理能力，比框架的新颖性更为重要。

多智能体税

额外的智能体必须购买可量化的忠诚度或延迟优势，否则系统会退化为更小的图结构。

出现的故障

缺乏检查点的中断丢失；路由器循环；工具生成的错误参数；图提取器虚构的边；在笔记本中调整过的融合权重从未被正式纳入系统。

带阈值的分阶段路径

部署控制图与混合检索机制。
收集标记为“关系对比-分块”类型的故障数据。
仅针对经过验证的多跳集合添加知识图谱。
使用分级答案进行基准测试，而非仅比较不同LLM的表现。

应警惕什么

“图结构总是更先进”这类说法、未经偏见审计的演示胜率，以及无法展示令牌变化量的多智能体设计。

在持续集成环境中保留用于路由决策和中断恢复的固定配置。将检查点存储视为需要备份的生产数据。在添加GraphRAG时，应在庆祝实体数量增加之前先测量实际混合环境中的令牌变化量。

为陷入僵局的中断和孤立线程编写操作手册。

相比复杂的嵌套结构，更倾向于使用职责明确的较少节点。

记录边缘选择信息，以便日后将其整合为确定性路由器。

在检查点系统中将评估流量与客户线程分开处理。

当服务指标中出现抢占现象时，重新评估最大并发数。

记录每张幻灯片所对应的图结构——是控制图还是数据图。

为陷入僵局的中断和孤立线程编写操作手册。

相比复杂的嵌套结构，更倾向于使用职责明确的较少节点。

记录边缘选择信息，以便日后将其整合为确定性路由器。

在检查点机制中将评估流量与客户线程分开。

当服务指标中出现抢占现象时，重新评估最大并发数。

记录每张图表所代表的控制图或数据图的含义。

为陷入僵局的中断和孤立线程编写操作手册。

相比复杂的嵌套结构，更倾向于使用职责明确的较少节点。

记录边缘选择信息，以便日后将其整合为确定性路由器。

在检查点机制中将评估流量与客户线程分开。

当服务指标中出现抢占现象时，重新评估最大并发数。

记录每张图表所代表的控制图或数据图的含义。

为陷入僵局的中断和孤立线程编写操作手册。

相比复杂的嵌套结构，更倾向于使用职责明确的较少节点。

记录边缘选择信息，以便日后将其整合为确定性路由器。

在检查点机制中将评估流量与客户线程分开。

当服务指标中出现抢占现象时，重新评估最大并发数。

记录每张图表所代表的控制图或数据图的含义。

为陷入僵局的中断和孤立线程编写操作手册。

相比复杂的嵌套结构，更倾向于使用职责明确的较少节点。

记录边缘选择信息，以便日后将其整合为确定性路由器。

在检查点机制中将评估流量与客户线程分开。

当服务指标中出现抢占现象时，重新评估最大并发数。

记录每张图表所代表的控制图或数据图的含义。

为陷入僵局的中断和孤立线程编写操作手册。

相比复杂的嵌套结构，更倾向于使用职责明确的较少节点。

记录边缘选择信息，以便日后将其整合为确定性路由器。

在检查点中将评估流量与客户线程分开。

当服务指标出现抢占现象时，重新评估最大并发数。

记录每张图表代表控制流程还是数据流程。

将评估结果与拒绝率指标与延迟值放在一起，以便在同一张表格中查看成本和质量情况。

将评估结果与拒绝率指标与延迟数据放在一起，以便在同一张表格中查看成本和质量情况。

将评估结果与拒绝率指标与延迟值放在一起，以便在同一张表格中查看成本和质量情况。

将评估结果与拒绝率指标与延迟数据放在一起，以便在同一张表格中查看成本和质量情况。

将评估结果与拒绝率指标与延迟值放在一起，以便在同一张表格中查看成本和质量情况。

将评估结果与拒绝率指标与延迟数据放在一起，以便在同一张表格中查看成本和质量情况。

将评估结果与拒绝率指标与延迟时间放在一起，以便在同一张表格中查看成本和质量情况。

将评估结果与拒绝率指标与延迟数据放在一起，以便在同一张表格中查看成本和质量情况。

将评估结果与拒绝率指标与延迟数据放在一起，以便在同一表格中查看成本与质量情况。

← 全部文章发送简报