跳到主要内容

会话记忆装载与历史上下文构建

上一篇我们看到 prepare 方法的第一步是装载会话记忆。这一步非常重要，因为它决定了系统能否理解用户的上下文，能否正确处理"它"、"这个"、"刚才说的"等指代。

步骤一：装载会话记忆​

在 prepare 方法中，第一步就是调用 summarizeHistory 方法：

// 第一步先装载会话记忆，包括长期摘要、近期窗口、回答窗口以及压缩信息。
ConversationTraceRecorder.StageHandle memoryStage = traceRecorder == null
    ? null
    : traceRecorder.startStage(ConversationTraceStageCode.MEMORY, chatMode == null ? "" : chatMode.name(), "正在装载会话记忆与最近窗口。", null);
ConversationMemoryContext memoryContext;
try {
    memoryContext = summarizeHistory(conversationId, traceRecorder);
    if (traceRecorder != null) {
        // 会话记忆装载完成后，把压缩覆盖范围、长期摘要和最近对话窗口写入追踪快照。
        traceRecorder.completeStage(memoryStage, "会话记忆装载完成。", java.util.Map.of(
            "compressionApplied", memoryContext != null && memoryContext.isCompressionApplied(),
            "coveredExchangeId", memoryContext == null ? 0L : memoryContext.getCoveredExchangeId(),
            "coveredExchangeCount", memoryContext == null ? 0 : memoryContext.getCoveredExchangeCount(),
            "compressionCount", memoryContext == null ? 0 : memoryContext.getCompressionCount(),
            "longTermSummary", memoryContext == null ? "" : safeText(memoryContext.getLongTermSummary()),
            "recentTranscript", memoryContext == null ? "" : safeText(memoryContext.getRecentTranscript()),
            "answerRecentTranscript", memoryContext == null ? "" : safeText(memoryContext.getAnswerRecentTranscript())
        ));
    }
}
catch (RuntimeException exception) {
    if (traceRecorder != null) {
        traceRecorder.failStage(memoryStage, "会话记忆装载失败。", exception.getMessage(), null);
    }
    throw exception;
}

这段代码做了三件事：

  1. 启动阶段追踪——记录会话记忆装载的开始时间
  2. 调用 summarizeHistory——真正的装载逻辑
  3. 记录追踪信息——把装载结果写入追踪快照

什么是 ConversationMemoryContext？​

ConversationMemoryContext 是会话记忆上下文对象，它包含了以下信息：

  • longTermSummary：长期摘要，总结了整个会话的主题和关键信息
  • recentTranscript：近期对话窗口，包含最近几轮的完整对话
  • answerRecentTranscript：回答窗口，只包含最近几轮的回答部分
  • compressionApplied：是否应用了历史压缩
  • coveredExchangeId：压缩覆盖到的最后一轮 ID
  • coveredExchangeCount：压缩覆盖的轮次数量
  • compressionCount：压缩次数

为什么需要会话记忆？​

在多轮对话中，用户经常会使用指代词，比如：

  • 用户第1轮："Java 的特点是什么？"
  • 系统回答："Java 是一种面向对象的编程语言..."
  • 用户第2轮："它的性能怎么样？"

如果系统没有会话记忆，就不知道"它"指的是 Java，无法正确回答问题。会话记忆就是为了解决这个问题。

summarizeHistory 方法的详细流程​

summarizeHistory 方法是会话记忆装载的入口，它的实现非常简洁：

private ConversationMemoryContext summarizeHistory(String conversationId, ConversationTraceRecorder traceRecorder) {
    return conversationMemoryService.loadMemoryContext(conversationId, traceRecorder);
}

付费内容提示

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

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

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