儀表板 API
這是什麼
透過 RESTful API 提供 Hermes 內部狀態（活躍對話、工具用量、佇列深度）的唯讀儀表板。
白話解釋
想像飛機駕駛艙內的儀表板——它不會駕駛飛機，但它告訴你飛行速度、引擎溫度和燃油油量，讓你知道一切是否正常運作。儀表板 API 就是 Hermes 的駕駛艙儀表板：一個用於監控代理健康狀態、查看正在發生的事情以及及早發現問題的視窗。
為什麼重要
當 Hermes 自動執行任務時——尤其是無人值守的情況——你可能需要知道它是否正常運作。某個排程任務是否失敗了？代理是否卡在一個循環中？API 成本是否異常飆升？儀表板 API 提供了回答這些問題所需的資料，無需手動檢查日誌或推測。
運作方式
儀表板 API 是一個輕量級的 HTTP 伺服器，公開結構化的 JSON 端點。它提供關於活躍對話、最近的工具呼叫、排程任務狀態和 API 使用統計的資訊。資料是唯讀的——你可以監控，但不能從儀表板控制。這使它對於整合到外部監控系統（如 Grafana 或 Datadog）也很有用。
具體範例
你注意到帳單比平時高，想要調查原因。
- 你查詢儀表板 API 以取得最近的 API 使用記錄。
- 儀表板顯示一個排程任務過去一週每小時執行了 60 次——原本應是每天一次。
- 你發現排程任務的 cron 表達式設定錯誤，導致了過度執行。
- 你修正排程任務——如果沒有儀表板，你可能需要更長的時間才會注意到這個問題。
如何連結
本筆記屬於基礎設施系列。最鄰近的概念包括：閘道、成本控制、代理執行環境。
來源證據
dashboard_api.py#DashboardServer— 提供儀表板端點的 HTTP 伺服器。dashboard_api.py#MetricsCollector— 從代理執行環境收集即時指標。
工作流程
- 尚無首次工作流程對應；此概念仍透過文章與來源證據存在於筆記庫圖譜中。
相關文章
- 目前暫無文章以此概念名稱或別名達到引用門檻（請參閱提及-挖掘政策）。