SuperAPI AI 工具集

aap-eda

部署与运维

查看项目

更新于 10-15 17:21

技能介绍

用途:该技能面向 Event-Driven Ansible(EDA)的运维管理,通过 MCP 服务器(仓库 sibilleb/AAP-Enterprise-MCP-Server,stdio 传输,Python via uv run eda.py)暴露 12 个工具,覆盖激活、规则手册、决策环境与事件流的操作与查询。

主要能力:激活管理 7 个工具——list_activations(列出全部激活)、get_activation(按 ID 查看详情)、create_activation(创建)、enable_activation(启用)、disable_activation(禁用)、restart_activation(重启)、delete_activation(删除)。规则手册与环境 3 个——list_rulebooks、get_rulebook、list_decision_environments。事件流与环境 2 个——create_decision_environment、list_event_streams。

使用方式:安装为 git clone 后 uv sync(或 pip install -e .),运行前需设置环境变量 EDA_URL(EDA API 端点,如 https://aap.example.com/api/eda/v1)和 EDA_TOKEN(EDA API 令牌,可与 AAP_TOKEN 一致)。典型流程为先 list_activations 查看状态,再用 get_activation 检查细节,按需执行启用、禁用、重启等生命周期操作。可与其他技能配合:EDA 触发 AAP 作业模板,激活前用 aap-lint 校验规则手册动作,生产环境启用前走 ServiceNow 变更请求,并用 GAIT 记录审计轨迹、通过 Slack 发送事件通知。

限制与注意:激活实时处理事件,启用或禁用会直接影响在线自动化,生产环境变更应受变更请求管控并记录审计。若工具调用返回认证或连接错误,应先检查 EDA_URL 与 EDA_TOKEN 是否有效;遇到超时、主机不可达或响应异常时,应直接向用户报告错误信息,不要编造结果;写入类操作失败后不要自动重试,需先确认再重试,以免状态不一致。