AI Agent、MCP 與 Agent Skill

Edge AI Agent 可以在 Edge Admin 中檢查配置、解釋執行狀態並提出變更建議。它既可以作為沉浸式頁面或彈窗使用，也可以透過已認證的 MCP 服務和可下載的 Agent Skill 使用。

此功能在 OpenResty Edge 26.9.1-1 中首次引入。

# 在 Edge Admin 中使用 AI Agent

在頁面右上角選擇 AI Agent，然後新建會話或從歷史記錄中選擇已有會話。來源篩選 預設顯示 Admin 會話，切換到 MCP 或 Skill 可以檢視相應整合建立的會話，這些會話在此只能檢視。

# 稽核會改變狀態的操作

只讀工具會直接執行。會改變 Edge 狀態的工具則會暫停並顯示確認卡片，其中包含工具 名稱、引數、目標資源和風險標籤。只有會話所有者可以處理該確認。

應像稽核其他管理變更一樣稽核 AI 建議：批准前先核對資源 ID 和引數，不要僅因為操作 由 AI 提出就批准破壞性變更。

# 連線 MCP 客戶端或 Agent Skill

開啟 工具 > MCP Server & Agent Skill，可獲取伺服器地址、API-Token 欄位、Claude 配置命令和 Skill 下載入口。

MCP 端點使用需要認證的 Streamable HTTP，並可返回 Server-Sent Events：

POST /admin-api/ai_agent/mcp

伺服器只暴露一個有狀態的 ai_agent 門面。請保留返回的 session_id；當呼叫要求 確認時，提交 approve 或 reject。

可移植 Agent Skill 的下載地址為 GET /admin-api/ai_agent/skills/oredge-ai-agent.zip。

請始終使用專用的最小許可權 API Token。所有入口都需要 AI Agent 許可權；透過認證也不會讓當前 Edge 使用者訪問本來無權訪問的資源。