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 用户访问本来无权访问的资源。