通过 API 管理 n8n 工作流和自动化。适用于列出工作流、激活/停用、检查执行状态、手动触发工作流或调试自动化问题。
n8n 工作流管理
功能概述
n8n 工作流管理是一项面向实际任务的技能,主要用于通过 REST API. 与 n8n 自动化平台交互.;Setup. 第一次设置:. :. 安装依赖性(虚拟环境):. 配置环境变量在 ~/.zshrc(或~/)中.。
核心要点
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。
使用与执行
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
结果检查与注意事项
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
n8n 工作流管理
通过 REST API 与 n8n 自动化平台交互。
配置
首次配置:
- 安装依赖(虚拟环境):
cd skills/n8n-1.0.2 python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt
- 在
~/.zshrc(或~/.bashrc)中配置环境变量:
export N8N_API_KEY="your-api-key-here" export N8N_BASE_URL="https://your-n8n-instance.com"
- 重载 Shell 并验证连接:
source ~/.zshrc ./skills/n8n-1.0.2/scripts/n8n.sh list-workflows --pretty
提示:在 n8n UI 中获取 API 密钥:设置 → API
快速参考
列出工作流
./scripts/n8n.sh list-workflows --pretty ./scripts/n8n.sh list-workflows --active true --pretty
获取工作流详情
./scripts/n8n.sh get-workflow --id--pretty
启用/停用工作流
./scripts/n8n.sh activate --id./scripts/n8n.sh deactivate --id
执行记录
# 列出最近的执行记录 ./scripts/n8n.sh list-executions --limit 10 --pretty # 获取执行详情 ./scripts/n8n.sh get-execution --id--pretty # 按工作流筛选 ./scripts/n8n.sh list-executions --id --limit 20 --pretty
手动执行
# 触发工作流 ./scripts/n8n.sh execute --id# 带输入数据执行 ./scripts/n8n.sh execute --id --data '{"key": "value"}'
Python API
如需编程方式调用:
from scripts.n8n_api import N8nClient
client = N8nClient()
# 列出工作流
workflows = client.list_workflows(active=True)
# 获取工作流
workflow = client.get_workflow('workflow-id')
# 启用/停用工作流
client.activate_workflow('workflow-id')
client.deactivate_workflow('workflow-id')
# 执行记录
executions = client.list_executions(workflow_id='workflow-id', limit=10)
execution = client.get_execution('execution-id')
# 执行工作流
result = client.execute_workflow('workflow-id', data={'key': 'value'})
常见任务
调试失败的工作流
- 列出含失败记录的最近执行
- 获取执行详情以查看错误信息
- 检查工作流配置
- 如有必要,停用该工作流
监控工作流健康状态
- 列出所有启用中的工作流
- 检查最近执行的状态
- 分析错误模式
工作流管理
- 列出全部工作流
- 审查各工作流的启用/停用状态
- 按需启用或停用工作流
- 删除过期的工作流
API 参考文档
详细的 API 文档请参阅 references/api.md。
故障排查
认证错误:
- 确认已正确设置
N8N_API_KEY:运行echo $N8N_API_KEY - 在 n8n UI 中检查 API 密钥是否有效
连接错误:
- 若使用自定义地址,请检查
N8N_BASE_URL是否配置正确
命令执行错误:
- 使用
--pretty参数获得格式化输出 - 确保在需要时提供了
--id参数 - 验证
--data参数传入的 JSON 格式是否合法
热门AI工具
相关专题
本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。
0
2026.10.22
本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。
0
2026.10.22
本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。
0
2026.10.22
本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。
0
2026.10.22
本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。
0
2026.10.22
本专题聚焦Golangci-lint YAML配置文件,讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置,便于团队统一检查标准。
0
2026.10.22
本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查,覆盖本地环境、Docker及多平台用法,帮助Go开发者快速上手。
0
2026.10.22
PHP2Shell漏洞是什么,哪些PHP版本和运行环境会受到影响,服务器应该如何检测与修复?本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤,以及修复验证、临时缓解和应急响应方案。
0
2026.10.22
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.5万人学习
共6课时 | 54.7万人学习
最新文章
