Agent Skills
返回列表
用户网络接入排障

用户网络接入排障

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_611ab5f2/ops-user-troubleshooting。

技能介绍

要解决什么问题

运维侧常见的一类工单是「用户上不了网」或「接入网络异常」。这类问题往往横跨认证、接入设备、DHCP、DNS多条链路，如果智能体随意跳步，很容易把根因说成「网络不通」却给不出可执行的结论。

本技能把两类典型场景写成固定流程：一是用户接入网络故障（需明确故障时间、用户名称/MAC/IP 至少一项、接入类型）；二是更泛化的用户无法上网（在接入排查通过后，再区分 DNS 等问题）。

技能如何工作

执行时依赖一组 MCP 工具拉取现场数据，而不是凭猜测推断：

  • getUserInfo：按名称/IP/MAC 拉取用户基本信息
  • getUserAuthStatus：核对认证是否成功及失败原因
  • getAccessDeviceByUserMac / getUserAuthDevice：定位 MAC 所在接入设备与认证设备是否在线
  • getDeviceArpExistByUserInfo：判断设备侧是否存在用户 ARP，用于区分 DHCP 是否正常

场景 1 按步骤走：认证失败则直接输出原因；设备离线则结束；有 ARP 则视为 DHCP 正常；无 ARP 则转调 /access-troubleshooting 的 DHCP 服务故障；找不到 MAC 则转调 /wired-troubleshooting 的设备故障。

场景 2 先完整跑场景 1；接入正常后再查 DNS（/access-troubleshooting DNS 服务中断）；仍正常则明确建议联系工程师处理上层或业务侧问题。

适用边界与注意点

  • 文档要求严格按照排查步骤执行，不宜在认证未查清时直接跳到 ARP 或外呼其他技能。
  • 子技能调用是流程的一部分：DHCP、DNS、有线设备故障分别交给 access-troubleshooting 与 wired-troubleshooting，本技能负责串联与用户维度的信息采集。
  • 参数不全（缺时间、用户标识）时，应先向用户补齐，否则 MCP 查询结果可能无法对齐故障时刻。

使用场景

  • 用户报「无法上网」时，按故障时间、用户名或 MAC/IP 先跑接入与认证链路，再决定是否查 DNS 或升级工程师。
  • 工单明确问「用户接入网络是否存在故障」时，严格按场景 1 从 getUserInfo、认证状态到 ARP 逐步给出可结束的结论。
  • 认证已通过但设备侧无用户 ARP 时，转调准入排障技能处理 DHCP 服务故障，而不是在对话里笼统归因。
  • getAccessDeviceByUserMac 查不到 MAC 时，转调有线排障技能排查接入设备故障，并输出设备离线等明确状态。

适合人员

  • 企业或园区网 NOC 一线，需要把「单用户上不了网」工单拆成认证、设备、DHCP、DNS 的可核对步骤。
  • 负责编排运维智能体的工程师，要把 getUserAuthStatus、ARP 查询等与准入/有线子技能按 SKILL 步骤串联。
  • 值班运维在用户提供不全标识时，知道必须先补齐故障时间与 MAC/IP/名称再调用 MCP，避免错时刻对账。
  • 处理接入类 SLA 的运维主管，希望智能体输出「认证失败原因」「认证设备离线」等可写入工单的根因表述。