跳到主要内容

历史回填怎样预览创建并执行

从请求入口看，回填要提交什么​

历史回填是用户主动请求的一次 L2 或 L3 重新计算。它读取已有高层谱系中记录的历史直接来源版本，生成一个待处理 Job。请求体给目标层级、规则版本和预期授权 revision；具体来源版本由后端查库决定。预览只给出计划，不会运行模型。

HighLevelMemoryEvolutionController 在同一个记忆库路径下提供预览、创建、暂停和恢复。先看前两个入口：

    /** 把 HTTP 参数转成回填预览命令；来源版本由服务端谱系查询决定。 */
    @PostMapping("/backfills/preview")
    ResponseEntity<Map<String, Object>> previewBackfill(
            @PathVariable("memoryAssetId") UUID memoryAssetId,
            @RequestBody BackfillRequest body,
            @RequestHeader("Idempotency-Key") UUID idempotencyKey,
            @RequestHeader(value = "X-Correlation-Id", required = false) UUID correlationId,
            HttpServletRequest request) {
        // 操作者来自前置认证，幂等键来自请求头，客户端只提交层级、规则和授权版本。
        WorkspaceCommandContext context = commandContext(request, idempotencyKey, correlationId);
        MemoryBackfill.Preview preview = backfills.preview(new MemoryBackfill.PreviewRequest(
                context, new MemoryAssetId(memoryAssetId), body.targetLevel(),
                new EvolutionRuleVersion(body.ruleVersion()),
                new AuthorizationRevision(body.expectedAuthorizationRevision())));
        return ResponseEntity.ok().cacheControl(CacheControl.noStore())
                .body(HighLevelMemoryEvolutionHttpMapper.preview(preview));
    }

    /** 创建前重新预览一次，随后将同一份冻结输入交给回填命令。 */
    @PostMapping("/backfills")
    ResponseEntity<Map<String, Object>> requestBackfill(
            @PathVariable("memoryAssetId") UUID memoryAssetId,
            @RequestBody BackfillRequest body,
            @RequestHeader("Idempotency-Key") UUID idempotencyKey,
            @RequestHeader(value = "X-Correlation-Id", required = false) UUID correlationId,
            HttpServletRequest request) {
        WorkspaceCommandContext context = commandContext(request, idempotencyKey, correlationId);
        // 请求体中的回填范围不直接进入 Job；每次创建都由后端计算预览。
        MemoryBackfill.Preview preview = backfills.preview(new MemoryBackfill.PreviewRequest(
                context, new MemoryAssetId(memoryAssetId), body.targetLevel(),
                new EvolutionRuleVersion(body.ruleVersion()),
                new AuthorizationRevision(body.expectedAuthorizationRevision())));
        MemoryBackfill.Run run = backfills.request(new MemoryBackfill.Request(context, preview));
        return ResponseEntity.ok().cacheControl(CacheControl.noStore())
                .body(HighLevelMemoryEvolutionHttpMapper.run(run));
    }

入口从认证后的请求取操作者，从 Idempotency-Key 请求头取幂等键，组装 WorkspaceCommandContext。预览直接返回后端算出的输入；创建接口会重新预览，再把这份预览交给 request()。因此，用户先前看到的预览和后来创建时的来源可能不同；创建时真正冻结的是后端当次重新计算的输入。响应设置 no-store，避免把治理结果留在浏览器缓存里。

历史回填创建顺序

付费内容提示

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

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

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

完整项目实战资料

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

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

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

加入后还能获得

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

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

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

扫码进入知识星球

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