跳到主要内容

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

上一篇讲完了 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(), "")
    ));
}

付费内容提示

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

加入星球后，你可以获得：

  • 超级八股文：100万+字的全栈技术知识库，涵盖技术核心、数据库、中间件、分布式等深度剖析的讲解
  • 讲解文档：超级AI智能体、黑马点评Plus、大麦、大麦pro、大麦AI、流量切换、数据中台的从0到1的详细文档
  • 讲解视频：超级AI智能体、黑马点评Plus、大麦、大麦pro、大麦AI、流量切换、数据中台的核心业务详细讲解
  • 1 对 1 解答：可以对我进行1对1的问题提问，而不仅仅只限于项目
  • 针对性服务：有没理解的地方，文档或者视频还没有讲到可以提出，本人会补充
  • 面试与简历指导：提供面试回答技巧，项目怎样写才能在简历中具有独特的亮点
  • 中间件环境：对于项目中需要使用的中间件，可直接替换成我提供的云环境
  • 面试后复盘：小伙伴去面试后，如果哪里被面试官问住了，可以再找我解答
  • 远程的解决：如果在启动项目遇到问题，本人可以帮你远程解决
进入星球后，即可享受上述所有服务，保证不会再有其他隐藏费用。
知识星球二维码

1. 打开微信 -> 扫描左侧二维码 -> 加入「JavaUp项目实战&技术讲解」知识星球

2. 查看星球使用指导，获取完整项目讲解资料索引

👉 点击解锁全部付费内容
🎁优惠