診斷中心

摘要

診斷中心用於排查 Hermes Agent 的異常情況。你可以在同一處查看和導出近期日誌、重置模型配置，或在保留數據的前提下重置 Hermes。當 Agent 不回覆、回覆異常或通道連接失敗時，這裏是第一個應該檢查的地方：先看日誌定位是模型調用失敗、通道斷開還是技能報錯，再選擇對應的處理動作。重置 Hermes 會保留數據，因此不必擔心丟失已沉澱的記憶。

---

診斷中心用於排查 Hermes Agent 的異常情況。你可以在同一處查看和導出近期日誌、重置模型配置，或在保留數據的前提下重置 Hermes。

當前入口與操作範圍

選擇出現問題的 Bot，打開「管理 → 診斷中心」，可查詢或導出 1、3、6、12、24 小時日誌。重置模型只作用於所選 Bot 的 Profile。「重置 Hermes（保留數據）」僅主 Bot 可操作，維護期間整個 Agent 的所有 Bot 都會暫時不可用。顯示備份恢復時，備份包含所有 Bot；恢復會覆蓋目標 Agent 的對應數據，結果通過綁定郵箱通知。需等待任務結果，不能把提交成功當成任務完成。

本頁覆蓋

• 查看和導出近期日誌
• 重置異常的模型配置
• 保留數據重置 Hermes
• 判斷何時應使用恢復操作，何時應尋求進一步幫助

建議按影響最小的方式處理： 先看日誌，再執行必要的修復操作。重置配置和重置 Hermes 更適合持續存在的問題。

開始前

1. 打開出現問題的 Agent。
2. 記錄異常表現、發生時間，以及它影響的是聊天、已連接的渠道，還是某一項具體任務。
3. 如果是模型無法使用，重置前先檢查配置模型中的當前設置。

打開診斷中心

1. 打開 Agents，選擇出現問題的 Agent。
2. 打開 診斷 區域。
3. 選擇近期日誌的時間範圍：1、3、6、12 或 24 小時。
4. 選擇 查詢 加載日誌。

優先選擇剛好覆蓋異常發生時間的最短範圍。時間窗口更小，通常更容易將錯誤和觸發它的操作對應起來。

查看和導出日誌

通過日誌確認 Agent 當時是否正常運行，並定位異常發生的時間。需要保留記錄或向支持人員説明問題時，可以將當前時間範圍內的日誌導出為文件。

反饋問題時，建議提供：

• 大致發生時間；
• 當時讓 Agent 執行的操作；
• 選用的日誌時間範圍；
• 相關報錯信息，但不要包含密鑰或 API Key 等敏感內容。

修復模型配置

如果 Agent 無法使用已配置的模型，並且確認過提供商、模型選擇和憑證後問題仍未解決，可在診斷中心選擇 Reset model configuration。

該操作只會重置當前 Bot 對應的 Hermes Profile：恢復系統內置模型及其憑證，並移除用户添加的模型、Provider 和備用模型。同一 Agent 中的其他 Bot 不受影響。完成後：

1. 在聊天中發送一條簡短消息，確認系統內置模型可用。
2. 如果仍需使用自定義模型，返回配置模型重新添加或選擇。

保留數據重置 Hermes

對於查看日誌和檢查模型設置後仍持續的問題，診斷中心提供 Reset Hermes (keep data)。它會重置 Hermes 運行環境，並保留數據。

1. 閲讀診斷中心顯示的操作説明。
2. 啓動重置後，保持頁面打開並留意狀態變化。
3. 完成後重新加載 Agent 控制台。
4. 在聊天中測試一項簡單任務，再檢查雲存儲和日常設置。

維護期間，Agent 可能暫時不可用。重置尚未完成時，請不要連續發起另一項修復操作。

備份與恢復：以控制台顯示為準

國際站默認不顯示備份恢復面板。若當前控制台已提供該入口，請先選中主 Bot 並確認賬號已綁定郵箱。

1. 在「Agent 備份與恢復」中選擇「備份到郵箱」，閲讀提示後提交，等待任務狀態和綁定郵箱中的結果。
2. 恢復時先保留不可替代的數據，再選擇「從備份恢復」，上傳兼容的 Hermes Agent ZIP 備份包，核對目標 Agent 後確認。恢復覆蓋整個目標 Agent 的對應數據，影響所有 Bot。
3. 通過「刷新」和任務詳情檢查完成或失敗狀態，再驗證各 Bot 的模型、文件、記憶和對話。提交成功不代表備份或恢復已經完成；已有維護任務時不要重複提交。

恢復前，請保留無法替代的文件副本。你可以先通過雲存儲檢查 Agent 當前保存的文件。

確認問題已解決

出現以下情況時，通常説明問題已恢復：

• 近期日誌不再重複出現同一錯誤；
• Agent 能在聊天中正常回復簡單測試；
• 預期的模型與文件可以再次正常使用。

若同一錯誤再次出現，請先導出相關日誌，並記錄下一次出現的時間，再繼續排查或反饋。

常見問題

應該選擇多長的日誌時間範圍？

選擇剛好包含問題的最短時間範圍。只有在問題更早開始或偶發出現時，才使用更長範圍。

重裝會清除 Agent 數據嗎？

診斷中心的操作標註為 Reset Hermes (keep data)，設計目標是保留數據。仍建議不要中斷維護過程，並在完成後檢查 Agent 狀態。

每次模型報錯都需要重置模型配置嗎？

不需要。請先在配置模型檢查所選模型和憑證，並確認提供商可用。僅在模型配置本身需要重新建立時，才使用重置。

下一步

• 回到聊天，測試修復後的 Agent。
• 遇到模型問題時，查看配置模型或模型切換。
• 任務依賴的文件缺失或無法訪問時，檢查雲存儲。