SuperAPI AI 工具集

pyats-parallel-ops

通用与其它

查看项目

更新于 10-15 17:21

技能介绍

用途:在网络设备集群上执行并行只读运维操作,包括健康检查、配置审计、路由快照和分级报告。

主要能力:使用 pyats.async_.pcall 实现按设备进程隔离的并行 fan-out,调用 pyats_pcall_show_command 时传入 device_names 与 command;pyats_run_show_command_multi 提供基于线程的较轻量并行采集,适合常规收集。返回结果包含每台设备结果、汇总和并发信息,需逐台验证,外层 status 为 completed 不代表全部成功。还可并行执行配置操作(pyats_pcall_configure_devices、pyats_configure_devices_multi),但并行不保证原子性。

使用方式:会话先调用 pyats_list_devices(传 {}),用返回的设备名按角色或站点分组并确认范围;禁止臆造设备名或从已保存 testbed 推断运行状态。每条命令发起一次集群调用,收集完本轮结果再进行下一轮。只读检查保持 init_config_commands: []。基于现代 pyATS MCP Streamable HTTP 服务器,无状态模式需在服务器设置 PYATS_MCP_TRANSPORT_MODE=stateless;该服务器不支持直接 STDIO,可用 scripts/pyats-stdio.py 桥接并设置 PYATS_MCP_SCRIPT。调用前先发现真实工具 schema。

适用场景与限制:适合实验室小规模分批的设备组,或按角色/站点分组的大规模集群,建议从 5–10 台起步并根据服务器与设备容量调整;采样必须标注为采样,不能证明未采样设备状态。仅支持受支持的 show 命令,禁止用 shell 管道、配置命令或破坏性操作走捷径。失败需逐个设备呈现,不得因 HTTP 200 判定健康;原始输出回退只证明命令执行,不等于结构化解析成功。配置变更须遵循 pyats-config-mgmt 与变更管理,取得批准的 ServiceNow 变更;只读授权不等同配置许可。保持配置文件、拓扑、凭据和设备输出本地化,凭据不得出现在报告中。最终输出按严重级别优先,再列设备、证据、影响和建议动作,记录请求/成功/失败数、命令、耗时及未验证项,并以 Fleet 汇总和 gait_log 结束。