跳到主要内容

图结构答案的渲染逻辑

前面两篇我们看完了执行器的主流程和查询引擎的工作细节，现在查询结果已经拿到了。最后一步就是把这些结构化的图数据变成用户能直接阅读的自然语言答案。这个工作由 GraphAnswerRenderer 来完成。

GraphAnswerRenderer 的入口​

@Service
public class GraphAnswerRenderer {

    public String renderGraphAnswer(ExecutionMode mode,
                                    DocumentNavigationDecision decision,
                                    GraphQueryResult graphResult) {
        // 如果结构图没有返回结果或没有命中目标章节，就没有可渲染的结构答案。
        if (graphResult == null || graphResult.getTargetSection() == null) {
            // 返回空串交给上层决定是否走无证据兜底。
            return "";
        }
        // GRAPH_THEN_EVIDENCE 模式会在结构关系之外继续补充条目或正文证据。
        if (mode == ExecutionMode.GRAPH_THEN_EVIDENCE) {
            // 交给证据增强渲染分支，优先回答具体步骤、命中条目或章节正文。
            return renderGraphThenEvidence(decision, graphResult);
        }
        // 默认按 GRAPH_ONLY 处理，只围绕结构图关系生成答案。
        return renderGraphOnly(decision, graphResult);
    }
}

入口方法做了三层判断：

  1. 结果为空 → 返回空串，上层执行器会用兜底文案替代
  2. GRAPH_THEN_EVIDENCE 模式 → 走证据增强渲染（这不是本篇重点，简单带过）
  3. GRAPH_ONLY 模式 → 走纯结构图渲染，这是我们要重点看的

renderGraphOnly：纯结构图渲染​

private String renderGraphOnly(DocumentNavigationDecision decision, GraphQueryResult graphResult) {
    // 从导航决策里取出动作，用来判断用户要的是相邻关系还是子章节展开。
    DocumentNavigationAction action = decision == null ? null : decision.getNavigationAction();
    // 取出重写后的检索问题，后面会用关键词辅助判断用户问题的真实意图。
    String question = decision == null || decision.getRetrievalPlan() == null
        ? ""
        : StrUtil.blankToDefault(decision.getRetrievalPlan().getRetrievalQuestion(), "");
    // 如果路由动作已经明确为相邻章节，或者问题文本里出现相邻关系关键词，就渲染前后章节。
    if (action == DocumentNavigationAction.SECTION_ADJACENCY_LOOKUP || asksAdjacency(question)) {
        // 相邻渲染会输出目标章节、父章节、上一节和下一节。
        return renderAdjacency(graphResult);
    }
    // 如果用户在问子章节，或者图查询本身已经带回了子章节列表，就渲染子章节清单。
    if (asksChildren(question) || !graphResult.getChildren().isEmpty()) {
        // 子章节渲染会输出目标章节下的直接子节点。
        return renderChildren(graphResult.getTargetSection(), graphResult.getChildren());
    }
    // 没有相邻关系和子章节展开需求时，只返回目标章节标题作为最简结构答案。
    return graphResult.getTargetSection().displayTitle();
}

付费内容提示

该文档的全部内容仅对「码力全开」项目实战&技术讲解 知识星球用户开放

加入星球，一次获得完整项目资料、全栈技术知识库和长期答疑服务。

100万+字全栈技术知识库深入讲解技术核心、数据库、中间件和分布式等内容
8套热门的实战项目持续更新的企业级项目覆盖高并发、微服务、数据中台 和 AI Agent 等方向
AI 技术知识大模型面试详解覆盖 AI 模型原理、Agent、RAG、MCP、Skills、Harness 等核心知识点
文档 + 视频两种讲解形式既能系统阅读，也能跟随视频理解核心业务

完整项目实战资料

每套项目均包含从 0 到 1 讲解文档核心业务讲解视频

从基础项目到复杂业务场景，项目资料会持续更新。

8 套项目
  • 01Nexus Agent AI 智能体
  • 02Nexus Agent Pro 完全版
  • 03黑马点评Plus
  • 04大麦
  • 05大麦Pro
  • 06大麦AI
  • 07流量切换
  • 08数据中台

加入后还能获得

进入星球后，即可享受上述所有服务，保证不会再有其他隐藏费用。

从学习、面试到项目启动，都可以继续获得支持。

  • 1 对 1 解答项目和技术问题都可以提问
  • 针对性补充没有讲清楚的内容会继续补充
  • 面试与简历指导梳理回答技巧和项目亮点
  • 中间件云环境项目依赖可以直接接入使用
  • 面试后复盘被问住的问题可以继续交流
  • 远程问题解决项目启动问题可协助排查
知识星球二维码

扫码进入知识星球

  1. 打开微信，扫描左侧二维码，加入「码力全开」项目实战&技术讲解 知识星球
  2. 查看星球使用指导，获取完整项目讲解资料索引
解锁全部付费内容
🎁优惠