REST + OpenAPI
使用 Bearer API Key 呼叫 /agent/v1。/agent/v1/openapi.json 提供介面說明,讓工具了解可用的請求。
把拓撲、指標、事件與診斷交給你使用的 AI 工具。透過 REST 或 MCP 接入,由你決定資源範圍、設定權限和修復預授權。
了解工具接入使用 Bearer API Key 呼叫 /agent/v1。/agent/v1/openapi.json 提供介面說明,讓工具了解可用的請求。
透過 /mcp 接入,可使用 API Key,或透過 OAuth PKCE 授權。REST 與 MCP 共用權限、任務和稽核規則。
選擇指定資源或全部帳戶資源,用功能權限(Scope)決定可讀取、診斷或修改什麼。全部資源範圍也包括以後新增的資源。
客戶端設定、分流規則、節點分流和來源安全的新增、修改、刪除或發布,需要授予對應管理權限。產生、執行與檢視任務,還需任務查詢權限。
為身分設定有效期、每分鐘呼叫額度和每日任務額度。API Key 只在建立或輪換時完整顯示一次,請儲存到憑證管理員;之後可以輪換或撤銷。
節點心跳異常時,授予診斷與計畫權限,讓工具讀取相關拓撲、指標和事件,產生修復計畫。在任務詳情檢視證據與計畫,再決定允許哪些修復。
修復預授權單獨選擇節點、動作、有效期與每日修復上限。可授權恢復節點服務、託管 Agent、自帶節點安裝,或處理失敗韌體升級;執行還需要相應 Scope。
目前修復預授權只用於無活動 Relay 的節點。執行時檢查計畫、資源、韌體身分與健康條件。修復可能短暫中斷節點服務,失敗會停止並保留具體原因。
診斷、計畫和執行都有任務記錄。證據與計畫可回查,執行結果與節點健康複核分別顯示,方便判斷服務是否恢復。
AI Agent 接入頁記錄 Key 管理、客戶預授權、介面呼叫、任務執行與複核,可按動作、結果和時間查找具體任務。
了解節點健康與恢復 →不會。授權時選擇團隊帳戶和 Agent 身分,應用只能使用這份身分已有的權限與資源範圍。存取權杖最長有效十五分鐘;輪換或撤銷 API Key,也會使原 OAuth 授權失效。
不能。計畫、執行與任務查詢分別需要對應權限,執行修復還需單獨預授權節點、動作、有效期和額度,並滿足執行時的維護條件。
撤銷停止新的存取和尚未執行的修復。已經派發的操作繼續跟蹤最終結果,在主控台查看任務狀態。