SuperAPI AI 工具集

pyats-network

通用与其它

查看项目

更新于 10-15 17:21

技能介绍

用途:通过 pyATS 对网络设备做自动化操作与验证,覆盖 Cisco IOS-XE、NX-OS 等平台;设备清单由测试床文件 $PYATS_TESTBED_PATH 定义,各安装不同,应先用 pyats_list_devices 确认真实设备名与平台。

调用方式:使用 $MCP_CALL 协议处理器调用 MCP 工具,示例:PYATS_TESTBED_PATH=$PYATS_TESTBED_PATH python3 $MCP_CALL "${PYATS_PYTHON:-python3} -u $PYATS_MCP_SCRIPT" TOOL_NAME 'ARGS_JSON'。首次使用前查看 readiness.json。

主要能力(8 个工具):pyats_list_devices 列出设备属性;pyats_run_show_command 执行 show 命令并尝试 Genie 结构化解析,命令须以 show 开头,禁止管道、重定向和 shell 字符,不能含 copy/delete/erase/reload/write/configure,查看运行配置和日志需用专用工具;pyats_configure_device 下发配置并自动进出配置模式,不要包含 configure terminal 或 end,需要时自行加 exit,受保护命令如 write erase、erase、reload、delete、format 被阻止;pyats_show_running_config 获取完整运行配置;pyats_show_logging 获取最近 250 条日志;pyats_ping_from_network_device 从设备本身发起 ping,返回成功率、RTT、丢包等结构化数据;pyats_run_linux_command 在 Linux 设备上执行 shell 命令;pyats_run_dynamic_test 以内联方式运行 pyATS AEtest 脚本,脚本在沙箱中执行,须内联定义 TEST_DATA,不能连接设备,超时 300 秒,禁止 os、sys、subprocess、socket、requests 等导入与 eval、exec、open 等函数。

扩展用法:可直接使用 pyATS 进行 Genie Learn 多命令特性快照(如 ospf、bgp、interface、routing、platform 等共 34 项)与 Genie Diff 状态对比。

限制与失败处理:若调用报认证或连接错误,先检查 PYATS_MCP_SCRIPT、PYATS_TESTBED_PATH 是否已设置且有效。工具报错(超时、主机不可达、响应异常)时应直接反馈错误信息,不得编造结果;只读调用可检查连通性后重试一次,改变状态或发送消息的操作在超时后不得直接重试,需先确认当前状态,保留审批与变更门禁。MCP Tasks 的任务句柄不代表执行成功或已获批准,取消无法撤回已发出的命令。