恢复与还原
本页内容
备份每小时捕获一次代理的状态。本页涵盖另一半内容：如何找回内容 — 从恢复意外删除的一个文件、将整个代理回滚到昨天，到使用故障设备的完整数据配置全新设备。
此处的各项操作均始于Device management中的备份标签页。
快速参考
| 我想要… | 使用 |
|---|---|
| 找回单个文件 | 在还原点上点击Browse files，然后下载或还原文件 |
| 查看文件随时间的变化 | 文件上的Version history |
| 查看备份以来的更改 | 还原点上的What changed |
| 回滚整个代理 | Restore to this point → Everything |
| 仅回滚文件或 wiki | Restore to this point → Only selected areas |
| 撤销刚刚执行的还原 | Undo this restore |
| 更换故障硬件 | Replace this device（“配置”标签页） |
| 退役代理 | Remove & reset device（“配置”标签页） |
该设计的一个安心保障：“系统会首先自动拍摄安全快照，因此此还原操作本身可以被撤销。” 还原绝不是一条单行道 — 您随时可以撤销并返回到操作之前的状态。
浏览还原点内部
点击任意还原点上的 Browse files 以打开 Browse backup — 这是代理在当时那一刻的文件只读视图，标题中包含还原点的时间和地区。
图 1：浏览还原点内部的工作区
通过浏览器，您可以：
- 在 Workspace、Wiki 和 Data 区域之间切换，并导航文件夹。开启 Show system files & folders 还可以查看代理的系统文件。
- 在恢复点内按文件名搜索，或者点击 All restore points 以 “搜索每一个恢复点——查找自此备份以来被删除或更改的文件。”
- View 文件、将其 Download（或通过 Download as archive 下载整个文件夹）到您的计算机——当您只需要查看旧版本而不恢复任何内容时，这非常方便。
- Restore to device — 将文件或文件夹原地放回代理上。使用 Select multiple items 可以同时恢复多个项目。
- Copy link to this location — 共享一个链接，以在同一位置打开浏览器。
可能包含密钥或凭据的文件在下载前会被标记，因为下载的内容是解密后的。
即使设备离线或已死机，浏览功能依然可用——因为备份存储在云端，所以设备故障不会阻止您读取（或下载）它的所有内容。这也是在更换设备之前提取数据的方式。
单个文件的版本历史
对于浏览器中的任何文件，Version history 会列出该文件发生更改的每一个恢复点，并带有时间戳和大小，因此您可以回溯文档并挑选您想要的准确版本。
图 2：跨恢复点的单个文件版本历史
每个版本都可以进行查看、下载、与上一版本进行比较（Compare with the previous version），或者通过 Restore this version to the device 进行恢复。
恢复点之间发生了什么变化
恢复点上的 What that changed 会列出自该备份以来添加、更改或删除的文件。
图 3：自恢复点以来的更改
使用它来回答“这个文件是什么时候消失的？”或者对恢复将要回滚的内容进行完整性检查。Open in file browser 可跳转至恢复点中的某个文件。可以在存储在同一地区的恢复点之间进行比较。
恢复
点击恢复点上的 Restore to this point 以打开 Restore this agent。对话框会告诉您代理将被回滚到什么时间点，以及自该时间点以来发生了哪些更改。
图 4：恢复此代理——选择全部，或仅选择特定区域
在 What to restore 下，选择：
- Everything — “内存、聊天记录、工作区文件和已安装的工具都会被备份替换；自此之后创建的任何内容都将被删除。代理将重新启动。”
- Only selected areas — “设备的其余部分保持不变，代理继续运行。” 选择要回滚的区域，例如工作区文件或 wiki。
要恢复所有内容：
- 选择 Everything。
- 可选：勾选 Also restore the software version from this backup，以便代理的数据和软件同时恢复——当代理上的工具或任何自定义内容停止正常工作时，这非常有用。
- 在 Type the device name to confirm: 下，准确输入代理的名称。
- 点击 Restore。
系统会首先自动创建一个 Safety 恢复点。代理会在替换数据期间短暂停止，然后以恢复后的状态重新上线。
如果备份存储在多个地区，请选择 Restore from region — “副本是完全相同的——选择要从中恢复的任意地区。”
单个文件
通过（上方）文件浏览器，将任意选择的特定文件放回原处——这是最精确的选项，适用于单个文档出现问题的情况。
观察恢复过程
在恢复运行期间，模块顶部的横幅会显示其进度——例如 Restoring file… 或 Restoring this agent…，并显示已恢复的进度以及剩余进度。
图 5：正在进行的文件恢复
完成后，横幅会显示 “The last file restore completed successfully.” 或 “The agent was restored successfully.”。完全恢复后，代理将重新启动："The backup has been restored. The agent is starting its services back up — this takes about a minute."
撤销此恢复
完全恢复完成后，Undo this restore 会*“将代理回滚到此恢复之前立即拍摄的自动安全快照——从而撤销恢复。”*如果发现恢复并不是正确的选择，也不会丢失任何数据。
更换设备
如果 AI Agent Processor 发生故障，点击 Replace this device（“配置”选项卡底部）可将所有内容迁移到新设备。“更换后的设备将接管此设备的名称、设置、访问权限和备份历史记录。旧设备将被停用，且无法再进行连接。”
图 6：更换设备 — 选择恢复点
对话框会分步引导您完成更换过程：首先输入更换设备的序列号或设备 ID，然后选择要恢复到该设备的内容，最后进行确认。
- 开启新设备电源并使其保持在线状态——它必须处于未配对且可访问的状态。
- 点击 Replace this device，输入更换设备的序列号或设备 ID（来自其二维码贴纸或设备底部或背面的标签），然后点击 Next。
- 在第二步（图 6）中，保持勾选 Restore a backup onto the new device，并从列表中选择一个 Restore point（默认情况下为最新备份）。可选：勾选 Also pin the software to the version from this restore point，然后点击 Next。
- 在 Type the device name to confirm: 下，准确输入旧设备的名称，然后点击 Replace device。
注意： “此操作无法撤销。旧设备将被立即停用，且更换设备上的所有数据都将被覆盖。”
新设备接管并恢复备份时，对话框会显示进度；如果您不想等待，可以点击 Continue in background。完成后："Device replacement complete — the new device is ready." 旧设备的恢复点将保留在“备份”选项卡中，并标有 Previous device，因此不会产生孤立项。
由于备份是每小时运行一次，因此硬件故障通常最多只会损失一小时的代理状态。
移除设备
点击 Remove & reset device（“配置”选项卡底部）可将 Physical Agent 从您的设施中退役。
图 7：移除和重置设备 — 将会发生什么，以及备份会受到什么影响
对话框解释了将会发生的情况：
- “设备将从该设施中移除，并失去所有访问权限。”
- “硬件上的所有数据都将被擦除，并返回到配对屏幕，准备好添加到任何设施中。”
- 如果代理托管了 Published Apps，系统会将其列出：“移除此代理将使这些应用程序离线。任何使用它们的用户都将失去访问权限。”
选择如何处理备份：
| 选项 | 发生的情况 |
|---|---|
| Make a final backup, then delete | 推荐。首先运行最终备份，在备份完成之前不会移除任何内容。现有备份将作为恢复源保留 |
| Keep existing backups, skip a final backup | "No new backup is taken. Previous restore points stay available." |
| Delete this agent and permanently erase all its backups | "This cannot be undone. No restore source will remain." |
点击 Next，然后确认：
图 8：键入代理名称以确认移除
- 在 Type the agent name exactly as shown (case sensitive): 下，输入代理名称。“名称必须完全匹配，包括大写字母。”
- 点击 Remove & reset device。
如果包含最终备份，则：“将首先运行最终备份，这可能需要几分钟时间。只有在确认备份完成后，设备才会遭到擦除。” 如果最终备份无法完成，则不会移除任何内容，并且您可以选择如何继续：Retry the backup、Remove without a backup 或 Keep this agent。如果设备处于离线状态，它将立即被移除，并会在下次开机连接时自行擦除。
其凭据（Performance Hub 连接、模型访问权限、通知密钥）在移除后会立即撤销。保留的备份将保存在您设施之下的云存储中，并可以为未来的代理提供种子数据——既可以通过 Replace this device 添加，也可以在添加代理时通过 Restore from a backup 添加。它们会像往常一样根据您的保留设置过期。
在退役硬件、归还设备或停用不再需要的代理时，移除是正确的途径。如果您要将代理移动到同一设施中的不同硬件上，请改用 Replace this device——“它会保留名称、设置和备份。”
移除 Cloud Agent
对于 Cloud Agent，请改用 Delete this cloud agent。它会移除此设施处的 Cloud Agent Instance 和代理注册，并提供关于如何处理其备份的相同选项。“Cloud Agent Instance 和磁盘将被移除。此操作无法撤销。”
相关页面
- 备份 — 频率、保留、固定和地区
- 入门指南 — 添加代理，包括从备份恢复
- Device management — “配置”（Configuration）选项卡
- 故障排除