SuperAPI AI 工具集

airflow

通用与其它

查看项目

更新于 10-15 17:20

技能介绍

用途:借助 af 命令行查询、管理和排查 Apache Airflow 工作流,覆盖 DAG、DAG 运行、任务日志、实例配置、系统健康与 API 探查。

主要能力:

  • 实例配置:af instance add/list/use/current/delete,支持 discover(先加 --dry-run 预览)、配置文件分层(全局、项目共享、项目本地)与 ${VAR} 环境变量引用。
  • DAG:af dags list/get/explore/source/pause/unpause/errors/warnings/stats。
  • 运行:af runs list/get/trigger/trigger-wait/delete/clear/diagnose。
  • 任务:af tasks list/get/instance/logs,日志支持 --try、--map-index。
  • 系统与配置:af health、af config version/show/connections/variables/variable/pools/pool/plugins/providers/assets。
  • 直接 API:af api <endpoint>,另有 af api ls 与 --filter 列出端点;字段语法 -F 自动转换类型、-f 保持字符串。
  • Registry 发现:af registry providers/modules/parameters/connections,可加 --version 指定版本,结果本地缓存。

使用方式:命令假定 af 已在 PATH,可通过 astro otto 运行,或 uv tool install astro-airflow-mcp 安装。也可用环境变量 AIRFLOW_API_URL、AIRFLOW_AUTH_TOKEN 或 AIRFLOW_USERNAME/AIRFLOW_PASSWORD,或 CLI 参数 --airflow-url、--token 指定实例。多数命令输出 JSON,可配合 jq 过滤。

适用场景:DAG 巡检、失败运行诊断、任务日志排查、系统健康检查、连接与变量查看、API 端点探查、编写 DAG 前核对算子签名。

限制:本地运行与部署相关流程由 Astro CLI 及相关技能负责,本技能不覆盖;缺少的安装与具体端到端步骤以原文为准,未提供部分暂未提供。使用 af instance discover 非 dry-run 会在 Astro Cloud 创建 API token,属敏感操作,须先预览并取得同意。