診斷中心
診斷中心用於排查 Hermes Agent 的異常情況。你可以在同一處查看和導出近期日誌、重置模型配置，或在保留數據的前提下重裝 Agent。
本頁覆蓋
- 查看和導出近期日誌
- 重置異常的模型配置
- 保留數據重裝 Agent
- 判斷何時應使用恢復操作，何時應尋求進一步幫助
建議按影響最小的方式處理： 先看日誌，再執行必要的修復操作。重置配置和重裝 Agent 更適合持續存在的問題。
開始前
- 打開出現問題的 Agent。
- 記錄異常表現、發生時間，以及它影響的是聊天、已連接的渠道，還是某一項具體任務。
- 如果是模型無法使用，重置前先檢查配置模型中的當前設置。
打開診斷中心
- 打開 Agents，選擇出現問題的 Agent。
- 打開 Diagnostics 區域。
- 選擇近期日誌的時間範圍：1、3、6、12 或 24 小時。
- 選擇 Refresh 加載日誌。
優先選擇剛好覆蓋異常發生時間的最短範圍。時間窗口更小，通常更容易將錯誤和觸發它的操作對應起來。
查看和導出日誌
通過日誌確認 Agent 當時是否正常運行，並定位異常發生的時間。需要保留記錄或向支持人員説明問題時，可以將當前時間範圍內的日誌導出為文件。
反饋問題時，建議提供：
- 大致發生時間；
- 當時讓 Agent 執行的操作；
- 選用的日誌時間範圍；
- 相關報錯信息，但不要包含密鑰或 API Key 等敏感內容。
修復模型配置
如果 Agent 無法使用已配置的模型，並且確認過提供商、模型選擇和憑證後問題仍未解決，可在診斷中心選擇 Reset model configuration。
該操作會初始化 Hermes Agent 的模型配置，以便重新設置。完成後：
保留數據重裝 Agent
對於查看日誌和檢查模型設置後仍持續的問題，診斷中心提供 Reinstall Agent (keep data)。它會執行 Hermes Agent 的後台重裝流程，並保留數據。
- 閲讀診斷中心顯示的操作説明。
- 啓動重裝後，保持頁面打開並留意狀態變化。
- 完成後重新加載 Agent 控制台。
- 在聊天中測試一項簡單任務，再檢查雲存儲和日常設置。
維護期間，Agent 可能暫時不可用。重裝尚未完成時，請不要連續發起另一項修復操作。
備份與恢復：以控制台顯示為準
部分賬户會在診斷中心看到 Backup & Recovery 面板。只有當你的控制台顯示該面板時，才按照其中的提示創建備份或恢復兼容的 Hermes 備份包；不要假設每個 Agent 或賬户都具備此選項。
恢復前，請保留無法替代的文件副本。你可以先通過雲存儲檢查 Agent 當前保存的文件。
確認問題已解決
出現以下情況時，通常説明問題已恢復：
- 近期日誌不再重複出現同一錯誤；
- Agent 能在聊天中正常回復簡單測試；
- 預期的模型與文件可以再次正常使用。
若同一錯誤再次出現，請先導出相關日誌，並記錄下一次出現的時間，再繼續排查或反饋。
常見問題
應該選擇多長的日誌時間範圍？
選擇剛好包含問題的最短時間範圍。只有在問題更早開始或偶發出現時，才使用更長範圍。
重裝會清除 Agent 數據嗎？
診斷中心的操作標註為 Reinstall Agent (keep data)，設計目標是保留數據。仍建議不要中斷維護過程，並在完成後檢查 Agent 狀態。
每次模型報錯都需要重置模型配置嗎？
不需要。請先在配置模型檢查所選模型和憑證，並確認提供商可用。僅在模型配置本身需要重新建立時，才使用重置。