备份和恢复 Agent

Backup 保存 Agent 可恢复的 state。执行破坏性 runtime 或 Agent 变更前先创建 backup；无法承受丢失的文件还应保留独立副本。

创建和列出 backup

mf backups create agt_xxx
mf backups list --agent-id agt_xxx

Restore 或删除时使用返回的 backup ID。脚本需要准确保存 ID 时请加 --json。

同一 workspace 同时只能运行一个备份或恢复任务。重叠请求会返回冲突；等待 当前任务结束后再重试。任务中断后，必须等文件操作停止并完成清理，才能重试。

从尚不支持 workspace 互斥的旧版本升级时，先暂停新的备份和恢复请求，等待 现有任务结束，再更新全部 API 实例，最后恢复请求。首次升级期间不要让新旧 API 版本同时接受备份任务。 只要仍有旧版本创建的无归属运行任务，数据库迁移就会拒绝继续。迁移成功后， 数据库会拒绝旧 API 创建新的无归属任务。

恢复 Agent

Restore 会替换 Agent 当前 state：

mf backups restore agt_xxx --backup-id abk_xxx --yes

CLI 要求显式传入 --yes，不会打开 interactive prompt。传入之前：

1. 核对 Agent ID 和 backup ID。
2. 停止或完成仍在写入 Agent 的工作。
3. 如果需要 rollback，先为当前 state 创建新的 backup，并等待其状态变为 succeeded。安全备份失败或超时后不要继续恢复。

Unattended restore 需要 machine-readable output 时再加 --json。

Restore 命令返回 operation ID。持续检查直到 operation 进入 terminal state：

mf backups get-restore abr_xxx

请求被接受不等于恢复完成；必须用 get-restore 核验最终状态。

删除 backup

mf backups delete abk_xxx --yes

警告： 删除不可恢复；没有 --yes 时 CLI 会拒绝执行。请先确认没有 rollback 或 audit workflow 仍引用它。

另请参阅

• 用 CLI 管理 Agent
• 用 CLI 管理 Runtime
• CLI 命令参考