跳到主要内容

执行计划的最终装配

前面两篇讲了 documentQuestionRouter.route 的执行模式判定和章节解析策略，这一篇来看 ChatPreparationOrchestrator#prepare 方法的最后一段——把所有准备好的信息装配成最终的执行计划。

执行模式兜底​

// 如果导航阶段没有给出明确 executionMode，则默认退回普通 RETRIEVAL 模式。
ExecutionMode executionMode = navigationDecision == null || navigationDecision.getExecutionMode() == null
    ? ExecutionMode.RETRIEVAL
    : navigationDecision.getExecutionMode();

documentQuestionRouter.route 理论上总会返回一个 executionMode，但为了防止意外情况（比如路由器返回 null），这里做了一个兜底：如果没有明确的执行模式，就默认走 RETRIEVAL（普通混合检索）。这是最保守也最安全的选择。

检索问题的最终确定​

// retrievalQuestion / retrievalSubQuestions 允许导航阶段进一步微调，若没有则沿用改写结果。
String retrievalQuestion = navigationDecision == null || navigationDecision.getRetrievalPlan() == null
    ? rewriteQuestion
    : firstNonBlank(navigationDecision.getRetrievalPlan().getRetrievalQuestion(), rewriteQuestion);
List<String> retrievalSubQuestions = navigationDecision == null || navigationDecision.getRetrievalPlan() == null
    || navigationDecision.getRetrievalPlan().getSubQuestions() == null || navigationDecision.getRetrievalPlan().getSubQuestions().isEmpty()
    ? rewriteSubQuestions
    : navigationDecision.getRetrievalPlan().getSubQuestions();

这里有个细节：retrievalQuestion 和 rewriteQuestion 是两个不同的字段。

  • rewriteQuestion：改写阶段产出的问题，用于记录"改写了什么"
  • retrievalQuestion：最终用于检索的问题，可能被导航阶段进一步微调

导航阶段（documentQuestionRouter）在构建 retrievalPlan 时，可能会对检索问题做进一步调整，比如加入章节上下文、精简问题表达等。如果导航阶段没有调整，就直接沿用改写结果。

子问题同理：优先用导航阶段的子问题，没有就用改写阶段的。

执行计划装配​

// 最终把记忆、改写、路由、时间敏感信息和无证据回复一起装配成执行计划。
return basePlan(question, chatMode, memoryContext, historyPlanningContext, historySummary, answerHistoryContext, currentDate, currentDateText,
    requiresCurrentDateAnchoring, requiresFreshSearch)
    // 这里开始在 basePlan 的公共骨架上，补上"本轮文档链路真正判定出来的执行模式"。
    .mode(executionMode)
    // 把文档路由器给出的结构导航决策挂进去，后续执行器会根据它决定走图查询还是混合检索。
    .navigationDecision(navigationDecision)
    // 用 rewrite 阶段产出的改写问题覆盖 basePlan 中"默认等于原问题"的占位值。
    .rewriteQuestion(rewriteQuestion)
    .rewriteSubQuestions(rewriteSubQuestions)
    // retrievalQuestion / retrievalSubQuestions 允许被导航阶段进一步调整，因此这里写入的是最终检索版本。
    .retrievalQuestion(retrievalQuestion)
    .retrievalSubQuestions(retrievalSubQuestions)
    // 下面这组 selectedDocument* 字段表示"当前真正路由到的主文档作用域"。
    .selectedDocumentId(routedDocumentId)
    .selectedDocumentName(routedDocumentName)
    .selectedTaskId(routedTaskId)
    // 而 retrievalDocumentIds / retrievalTaskIds 表示"候选检索范围"，可以比 selectedDocument* 更宽。
    .retrievalDocumentIds(routedDocumentIds)
    .retrievalTaskIds(routedTaskIds)
    // 文档模式下的无证据回复需要按问题类型做定制提示，因此在这里覆盖 basePlan 的默认兜底文案。
    .noEvidenceReply(buildDocumentModeNoEvidenceReply(question, requiresFreshSearch))
    .build();

付费内容提示

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

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

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. 查看星球使用指导，获取完整项目讲解资料索引
解锁全部付费内容
🎁优惠