MiniMax Agent 默认不会开启断点续跑功能，任务一旦中断，系统通常会从头开始重试；如需恢复到中断位置继续执行，必须手动启用“任务状态快照”，并在指令前使用【/resume】前缀，或通过指定 #step=N 的方式从某一步重启，同时该任务还必须至少成功执行过一次。

在 MiniMax Agent 中，如果你提交了一个包含 5 个步骤的报告生成任务，执行到第 3 步时突然中断，随后点击“继续”却发现第 1 步又重新跑了一遍，这一般并不是模型异常或系统故障，而是因为默认未启用状态持久化与断点续跑能力，导致多步骤任务在恢复时出现重复执行。

启用 Ma vis 模式下的断点续跑

自 2026 年 5 月起，MiniMax 默认启用 Ma vis 多智能体协作架构，但断点续跑功能仍需用户手动开启。否则，一旦 Worker 执行失败或任务被中断，系统就会按照默认逻辑从第一步重新尝试。

第一步：在 Desktop App 左下角点击「设置」→「Agent 行为」→勾选「启用任务状态快照」。

第二步：返回对话界面，在输入指令前添加前缀 【/resume】，例如：【/resume】整理 ~/Downloads 中所有会议纪要 PDF，提取发言时间线并生成摘要表格。

第三步：提交后，Leader 智能体会自动读取最近一次 Checkpoint（通常保存在本地 SQLite 数据库中）。已经成功完成的步骤会被直接跳过，任务流程可从第 4 步继续执行。如果第 3 步之前曾执行失败，Verifier 也不会立即全量重放全部步骤，而是会先检查该步骤日志，再决定是否需要重新执行。

注意：该模式仅对通过 ToolRegistry 调用外部工具的任务有效；如果是纯文本生成类任务，则不会触发 Checkpoint 记录。

手动指定从某一步重启

当系统没有自动识别断点，或者你希望跳过某个中间步骤时，可以手动指定任务从哪一步开始恢复。

方法一：在指令末尾添加 #step=4，例如：“分析用户调研问卷数据 → 生成可视化图表 → 输出 PPT 初稿 #step=3”。

方法二：点击右侧任务栏中对应任务的「⋯」→「编辑执行路径」→在 DAG 图中右键点击节点“生成可视化图表”，选择「设为起点」。

【关键前提】：该任务必须已经成功运行过至少一次，并且调度器（AgentScheduler）记录了完整执行链路；如果是首次运行，则无法直接指定 step 参数。

避免重复执行的底层配置

在批量任务或多步骤自动化场景中，任务重复执行通常与工具调用缺少幂等性校验有关。MiniMax 默认可对文件移动、API 请求等操作提供 dry-run 预检能力，但这一功能需要开发者或用户主动开启。

进入「设置」→「高级工具选项」→打开「沙箱工具幂等开关」。

开启后，每次执行 mv、cp、curl 等命令前，系统都会先检查目标路径下是否已存在同名文件，以及目标 URL 是否返回过相同响应哈希值。若检测到结果已存在，则会自动跳过该步骤，并直接标记为 SUCCESS。

如果这一步没有配置好，那么在上传 100 个 PDF 并行解析时，一旦某个 Worker 崩溃后触发重试，就可能导致同一份 PDF 被重复 OCR 两次，最终生成重复数据或重复条目。