SuperAPI AI 工具集

pyats-linux-system

部署与运维

查看项目

更新于 10-15 17:21

技能介绍

用途:通过 pyATS MCP 对 Linux 主机执行只读系统操作,覆盖进程监控、文件系统检查、Docker 容器资源统计与系统工具验证,适合主机健康检查、Docker 集群监控、进程审计和系统就绪性核查。

前置条件:Linux 主机需先在 pyATS testbed 中定义,os 设为 linux,type 设为 linux,并配置基于 SSH 的 cli 连接(含 ip、port)与凭据(用户名、密码可引用环境变量)。

调用方式:所有命令统一使用 pyats_run_linux_command。示例: PYATS_TESTBED_PATH=$PYATS_TESTBED_PATH python3 $MCP_CALL "${PYATS_PYTHON:-python3} -u $PYATS_MCP_SCRIPT" pyats_run_linux_command '{"device_name":"linux-host-01","command":"ps -ef"}'

主要能力:进程监控可列出全部进程(ps -ef)或按名称过滤(ps -ef | grep nginx);Docker 操作可采集单次快照容器统计(docker stats --no-stream),查看 CPU、内存、网络 I/O、块 I/O 与 PID;文件系统检查可列出当前或指定目录(ls -l /var/log 等);工具验证可查看 curl 版本与协议、TLS 支持(curl -V)。

典型工作流包括 Linux 主机健康检查、Docker 集群监控、进程审计和系统就绪性检查;同一命令可通过 pCall 模式在多个主机上并发执行,由智能体汇总结果,也可与网络、并行运维、健康检查等技能衔接。

限制与约束:命令默认为只读,不使用 kill、rm、shutdown、reboot 或停止服务等破坏性命令;写入操作需经 ServiceNow 变更请求审批;执行前应先调用 pyats_list_devices 确认主机存在;grep 模式需避免 shell 元字符;每次执行须记录到 GAIT。若工具返回认证或连接错误,应先检查 PYATS_MCP_SCRIPT、PYATS_TESTBED_PATH 是否设置有效;工具报错时应直接报告错误信息,不应臆测结果。对于超时等结果未知的调用,不应在未确认状态前重复执行。