跳到主要内容

执行计划后处理与上下文同步

上一篇讲完了 ChatPreparationOrchestrator#prepare 方法的全部流程，它的返回值 ConversationExecutionPlan 就是本轮对话的"执行计划"。但这个计划产出来之后，还不能直接交给执行器用，还需要经过一层后处理——这就是 BusinessChatService#prepareExecutionPlan 方法做的事情。

方法全貌​

/**
 * 准备本轮对话真正要执行的计划，并将其结果同步回 TaskInfo 与上下文。
 * 这个方法是"会话启动完成"与"真正执行器开始工作"之间的桥接层：
 * 会先调用编排器产出最终执行计划，再把计划里确定下来的文档范围、Agent 问题、调试信息等回写到运行态对象中。
 *
 * 这里主要做三件事：
 * 1. 固化编排阶段的结果，避免后续执行链重复计算；
 * 2. 当自动路由重定向了文档范围时，同步刷新会话持久层作用域；
 * 3. 重建最终版 debugTrace，让后续执行器和收尾逻辑拿到的是"本轮最终执行计划"的调试快照。
 */
private ConversationExecutionPlan prepareExecutionPlan(TaskInfo taskInfo) {

    // 在这里统一完成问题改写、历史压缩、模式判定、检索规划等准备动作。
    ConversationExecutionPlan executionPlan = chatPreparationOrchestrator.prepare(taskInfo);

    // 基于准备好的执行计划重新渲染 Agent 问题，确保时间锚定、历史摘要和最新路由结果都被带入提示词。
    executionPlan.setAgentQuestion(buildAgentQuestion(executionPlan));

    if (executionPlan.getSelectedDocumentId() != null
        && !Objects.equals(executionPlan.getSelectedDocumentId(), taskInfo.selectedDocumentId())) {
        // 如果执行计划重新选择了文档范围，需要同步刷新持久层会话范围和运行时上下文。
        conversationArchiveStore.refreshSessionScope(
            taskInfo.conversationId(),
            executionPlan.getChatMode(),
            executionPlan.getSelectedDocumentId(),
            executionPlan.getSelectedDocumentName()
        );
        // 同时把最新文档范围回写到 runnableConfig 上下文，保证执行器和工具链读取到的是同一份作用域信息。
        putContextIfNotNull(taskInfo.runnableConfig(), ChatContextKeys.SELECTED_DOCUMENT_ID, executionPlan.getSelectedDocumentId());
        putContextIfNotBlank(taskInfo.runnableConfig(), ChatContextKeys.SELECTED_DOCUMENT_NAME, executionPlan.getSelectedDocumentName());
        putContextIfNotNull(taskInfo.runnableConfig(), ChatContextKeys.SELECTED_TASK_ID, executionPlan.getSelectedTaskId());
    }

    // 把最新执行计划与调试信息写回任务对象，供执行器和最终收尾逻辑统一读取。
    taskInfo.setExecutionPlan(executionPlan);

    // 用最终 executionPlan 重建一版 debugTrace，避免继续沿用初始化阶段的占位信息。
    taskInfo.setDebugTrace(initializeDebugTrace(executionPlan));
    taskInfo.runnableConfig().context().put(ChatContextKeys.DEBUG_TRACE, taskInfo.debugTrace());
    return executionPlan;
}

整个方法按顺序做了四件事，下面逐一展开。

第一步：调用编排器​

ConversationExecutionPlan executionPlan = chatPreparationOrchestrator.prepare(taskInfo);

这就是前面十几篇文档讲的那一大段流程——问题改写、文档路由、执行模式判定、执行计划装配，全部在这一行完成。返回的 executionPlan 已经包含了本轮对话所需的所有信息。

第二步：渲染 Agent 问题​

executionPlan.setAgentQuestion(buildAgentQuestion(executionPlan));

prepare 方法产出的执行计划里，agentQuestion 字段还是空的。这里调用 buildAgentQuestion 把它填上：

private String buildAgentQuestion(ConversationExecutionPlan executionPlan) {
    return promptTemplateService.render(PromptTemplateNames.AGENT_QUESTION, Map.of(
        "currentDateText", StrUtil.blankToDefault(executionPlan.getCurrentDateText(), ""),
        "requiresCurrentDateAnchoring", executionPlan.isRequiresCurrentDateAnchoring(),
        "requiresFreshSearch", executionPlan.isRequiresFreshSearch(),
        "hasHistorySummary", StrUtil.isNotBlank(executionPlan.getHistorySummary()),
        "historySummary", StrUtil.blankToDefault(executionPlan.getHistorySummary(), ""),
        "question", StrUtil.blankToDefault(executionPlan.getOriginalQuestion(), "")
    ));
}

付费内容提示

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

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

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