用途:面向网络设备的日常/周期性主动健康巡检、变更前后验证、告警后的首轮排查、容量趋势与运维就绪合规检查。
主要能力:按固定顺序执行八个步骤——设备标识与运行时长(show version)、CPU(show processes cpu sorted)、内存(show processes memory sorted、show platform resources)、接口状态与计数器(show ip interface brief、show interfaces)、硬件与环境(show inventory、show platform)、NTP 同步(show ntp associations、show clock)、系统日志(pyats_show_logging)、连通性验证(pyats_ping_from_network_device)。每项给出 HEALTHY/WARNING/HIGH/CRITICAL 阈值判定,并按 CRITICAL > HIGH > WARNING > HEALTHY 汇总,输出汇总表。
用法:调用依赖 PYATS_MCP_SCRIPT、PYATS_TESTBED_PATH 等环境变量,典型调用形式为 PYATS_TESTBED_PATH=$PYATS_TESTBED_PATH python3 $MCP_CALL "${PYATS_PYTHON:-python3} -u $PYATS_MCP_SCRIPT" pyats_run_show_command '{"device_name":"R1","command":"show version"}',其余步骤替换 command 参数。可用 pyats_list_devices 列出设备后并发巡检全量设备并生成舰队汇总表。若配置了 NETBOX_MCP_SCRIPT,可在第 1、4 步后与 NetBox 的接口与 IP 数据交叉比对;完成后可用 GAIT_MCP_SCRIPT 的 gait_record_turn 记录会话。
适用场景:IOS-XE 等平台的单设备或批量巡检、变更前后基线对比、故障初判。
限制:具体支持平台范围、权限要求、最低版本、依赖安装方式与许可信息资料未提供;工具调用失败时应先检查环境变量,发生超时或不可达时如实报告错误,不猜测结果;涉及改变状态的操作需保留审批与变更门禁,超时后先核查实际状态再决定是否重试;文中审计内容为例示,应以实际观测证据替换。