诊断中心

摘要

诊断中心用于查看和导出 Hermes Agent 日志，并在模型配置异常或运行状态持续异常时执行恢复操作。 建议先用最短时间范围定位问题，再按影响从小到大的顺序选择刷新日志、重置模型配置或保留数据重置 Hermes。

---

诊断中心用于排查 Hermes Agent 的异常情况。你可以在同一处查看和导出近期日志、重置模型配置，或在保留数据的前提下重置 Hermes。

当前入口与操作范围

选择出现问题的 Bot，打开「管理 → 诊断中心」，可查询或导出 1、3、6、12、24 小时日志。重置模型只作用于所选 Bot 的 Profile。会话修复需确认后执行，Hermes 会检查会话数据库，发现异常时先备份再修复。「重置 Hermes（保留数据）」仅主 Bot 可操作，维护期间整个 Agent 的所有 Bot 都会暂时不可用。显示备份恢复时，备份包含所有 Bot；恢复会覆盖目标 Agent 的对应数据，结果通过绑定邮箱通知。需等待任务结果，不能把提交成功当成任务完成。

本页覆盖

• 查看和导出近期日志
• 重置异常的模型配置
• 保留数据重置 Hermes
• 判断何时应使用恢复操作，何时应寻求进一步帮助

建议按影响最小的方式处理： 先看日志，再执行必要的修复操作。重置配置和重置 Hermes 更适合持续存在的问题。

开始前

1. 打开出现问题的 Agent，并选中需要排查的 Bot。
2. 记录异常表现、发生时间，以及它影响的是聊天、已连接的渠道，还是某一项具体任务。
3. 如果是模型无法使用，重置前先检查配置模型中的当前设置。

打开诊断中心

1. 打开管理台，选择出现问题的 Bot。
2. 在「管理」中打开诊断中心。
3. 选择近期日志的时间范围：1、3、6、12 或 24 小时。
4. 选择 查询 加载日志。

优先选择刚好覆盖异常发生时间的最短范围。时间窗口更小，通常更容易将错误和触发它的操作对应起来。

查看和导出日志

通过日志确认 Agent 当时是否正常运行，并定位异常发生的时间。需要保留记录或向支持人员说明问题时，可以将当前时间范围内的日志导出为文件。

反馈问题时，建议提供：

• 大致发生时间；
• 当时让 Agent 执行的操作；
• 选用的日志时间范围；
• 相关报错信息，但不要包含密钥或 API Key 等敏感内容。

修复模型配置

如果 Agent 无法使用已配置的模型，并且确认过提供商、模型选择和凭证后问题仍未解决，可在诊断中心选择 Reset model configuration。

该操作只会重置当前 Bot 对应的 Hermes Profile：恢复系统内置模型及其凭证，并移除用户添加的模型、Provider 和备用模型。同一 Agent 中的其他 Bot 不受影响。完成后：

1. 在聊天中发送一条简短消息，确认系统内置模型可用。
2. 如果仍需使用自定义模型，返回配置模型重新添加或选择。

执行会话修复

选中出现异常的 Bot，在「会话修复」卡片点击「执行」，阅读确认提示后再提交。Hermes 会先检查会话数据库，并在修复损坏前生成备份；等待执行结果，再新建网页对话测试。若失败，先查看该 Bot 的日志和错误提示，不要把开始执行当成已修复，也不要连续提交其他维护操作。

保留数据重置 Hermes

对于查看日志和检查模型设置后仍持续的问题，诊断中心在主 Bot 上提供 重置 Hermes（保留数据）。它会重置 Hermes 运行环境，并保留数据。非主 Bot 看不到可用的重置入口时，请先切回主 Bot，不要把模型配置重置当成同一操作。

1. 阅读诊断中心显示的操作说明。
2. 启动重置后，保持页面打开并留意状态变化。
3. 完成后重新加载 Agent 控制台。
4. 在聊天中测试一项简单任务，再检查云存储和日常设置。

维护期间，Agent 可能暂时不可用。重置尚未完成时，请不要连续发起另一项修复操作。

备份与恢复：以控制台显示为准

国内站在主 Bot 的「管理 → 诊断中心」提供「Agent 备份与恢复」。开始前，确认实例正在运行、账号已绑定邮箱，且没有其他备份、恢复或维护任务进行中。

1. 选择「备份到邮箱」，阅读确认提示后提交。查看任务状态，并等待绑定邮箱中的结果。备份包含整个 Agent 中所有 Bot 的配置、工作空间、记忆和已安装技能。
2. 恢复前先保留不可替代的数据。选择「从备份恢复」，上传兼容的 Hermes Agent ZIP 备份包，核对目标 Agent 和备份文件后确认。恢复会覆盖目标 Agent 的对应数据，影响所有 Bot。
3. 通过「刷新」和「查看备份或恢复详情」检查完成或失败状态，再逐个验证 Bot 的模型、文件、记忆和对话。提交成功不代表任务完成；失败时先看任务详情，不要重复叠加维护操作。

恢复前，请保留无法替代的文件副本。你可以先通过云存储检查 Agent 当前保存的文件。

确认问题已解决

出现以下情况时，通常说明问题已恢复：

• 近期日志不再重复出现同一错误；
• Agent 能在聊天中正常回复简单测试；
• 预期的模型与文件可以再次正常使用。

若同一错误再次出现，请先导出相关日志，并记录下一次出现的时间，再继续排查或反馈。

常见问题

应该选择多长的日志时间范围？

选择刚好包含问题的最短时间范围。只有在问题更早开始或偶发出现时，才使用更长范围。

重装会清除 Agent 数据吗？

诊断中心的操作标注为 Reset Hermes (keep data)，设计目标是保留数据。仍建议不要中断维护过程，并在完成后检查 Agent 状态。

每次模型报错都需要重置模型配置吗？

不需要。请先在配置模型检查所选模型和凭证，并确认提供商可用。仅在模型配置本身需要重新建立时，才使用重置。

下一步

• 回到聊天，测试修复后的 Agent。
• 遇到模型问题时，查看配置模型或模型切换。
• 任务依赖的文件缺失或无法访问时，检查云存储。