SuperAPI AI 工具集

aap-automation

通用与其它

查看项目

更新于 10-15 17:21

技能介绍

用途:通过 MCP 服务器对接 Red Hat Ansible Automation Platform(AAP)控制器,用工具调用方式管理清单、主机、作业模板与项目等企业自动化资源。

主要能力(共 45 个工具):清单与主机管理 11 个,含列出/获取/创建/删除清单,列出主机、获取主机详情与 facts、增删改主机、列出失败主机;分组管理 6 个;作业与模板管理 8 个,含创建模板、run_job 执行、job_status 查询状态、job_logs 获取日志;项目管理 7 个,含 update_project 触发 SCM 同步及其状态与日志;清单源 6 个,含创建与手动 sync_inventory_source;临时命令 3 个;Galaxy 搜索 4 个。

使用方式:传输为 stdio,通过 uv run ansible.py 启动 Python 服务;安装用 git clone 加 uv sync(或 pip install -e .)。需配置环境变量 AAP_URL(控制器 API 端点)与 AAP_TOKEN(写权限令牌)。运行 playbook 的典型流程为 list_inventories、list_hosts、list_job_templates、run_job、job_status、job_logs,再按主机汇总成功与失败。

适用场景:清单审计、项目 SCM 同步、临时命令执行、Galaxy 内容检索,以及与其他技能(如 aap-eda、aap-lint、netbox-reconcile、nautobot-sot、servicenow-change-workflow、github-ops、pyats-health-check、gait-session-tracking)协作。

限制与注意事项:作业执行会改变基础设施,执行前须确认目标清单与模板;生产环境建议用变更请求门禁;操作应记入审计轨迹;实验环境自签名证书会被自动处理。工具调用出现认证或连接错误时,先检查 AAP_TOKEN、AAP_URL 是否有效;发生超时、主机不可达或响应异常时,应直接报告错误信息,不得编造结果;写操作失败后不要自动重试,须先向用户确认,以免状态不一致。缺失事项目前资料未提供。