让 AI 排查。执行听你安排。

把拓扑、指标、事件与诊断交给你使用的 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 管理、客户预授权、接口调用、任务执行与复核，可按动作、结果和时间查找具体任务。

OAuth 授权，会扩大 Agent 已有权限吗？

不会。授权时选择团队账户和 Agent 身份，应用只能使用这份身份已有的权限与资源范围。访问令牌最长有效十五分钟；轮换或撤销 API Key，也会使原 OAuth 授权失效。

给了诊断权限，就能自动执行修复吗？

不能。计划、执行与任务查询分别需要对应权限，执行修复还需单独预授权节点、动作、有效期和额度，并满足执行时的维护条件。

撤销身份，会取消已经下发的操作吗？

撤销停止新的访问和尚未执行的修复。已经派发的操作继续跟踪最终结果，在控制台查看任务状态。