n8n Workflow Management 是一个通过 REST API 与 n8n 自动化平台交互的技能,用于管理 n8n 的工作流与自动化任务。
用途方面,该技能主要面向工作流管理、执行记录查看与自动化任务操作。当需要处理 n8n 工作流、执行记录或自动化任务(例如列出工作流)时可以使用。
主要能力包括:列出工作流(可筛选活跃状态)、获取工作流详情、激活或停用工作流、列出执行记录(支持按数量限制和按工作流筛选)、获取执行详情、手动触发工作流以及携带数据触发工作流。此外还提供 Python API 供程序化访问,包括 list_workflows、get_workflow、activate_workflow、deactivate_workflow、list_executions、get_execution、execute_workflow 等方法。
使用方式分为命令行与 Python 两种。首次使用需在环境中存储 API 密钥:export N8N_API_KEY="your-api-key-here",可通过 python3 scripts/n8n_api.py list-workflows --pretty 验证连接;如需持久化,可将导出命令写入 ~/.bashrc 或 ~/.zshrc。常用命令包括:列出工作流并格式化输出,获取指定工作流详情,激活与停用工作流,列出近期执行记录,获取执行详情,按工作流筛选执行记录,手动触发工作流,以及通过 --data 传入 JSON 数据触发工作流。Python 侧则从 scripts.n8n_api 导入 N8nClient 并实例化后调用相应方法。更详细的 API 文档参见 references/api.md。
适用场景涵盖:调试失败的工作流(列出近期失败执行、查看执行详情定位错误、检查工作流配置、必要时停用)、监控工作流健康状况(列出活跃工作流、检查近期执行状态、审查错误模式),以及常规工作流管理(列出全部工作流、查看活跃与停用状态、按需激活或停用、删除旧工作流)。
限制与注意事项方面,该技能依赖 N8N_API_KEY 环境变量进行鉴权,使用自定义 URL 时需检查 N8N_BASE_URL;若出现鉴权错误,可验证 N8N_API_KEY 是否已设置,并在 n8n 界面确认密钥有效;若出现连接错误,检查 N8N_BASE_URL;命令报错时,可使用 --pretty 标志获得可读输出,在需要时确认已提供 --id,并校验 --data 参数的 JSON 格式。关于收费方式、价格、平台支持范围等具体信息,资料暂未提供。