AIKraft/AI/Войти
AIKraft/Skills/Обработка ошибок n8n

Обработка ошибок n8n

Use when building any webhook-triggered workflow, scheduled/production-bound workflow, wiring a per-node error output, or any workflow where silent failure would drop user-visible work. Triggers on

n8n-io official Другое

Что делает навык

Настройка обработки ошибок в n8n для обеспечения видимости сбоев, структурирования отчётов и восстановления работы. Позволяет избежать ситуации, когда интеграция просто перестаёт работать без логов и сообщений об ошибке.

Когда применять

  • Создание workflow, запускаемого через webhook (API-shaped workflow)
  • Настройка плановых задач (scheduled/cron) или очередей (queue-driven)
  • Подключение вывода ошибок отдельной ноды с использованием Respond to Webhook
  • Обработка тихих сбоев, приводящих к потере видимости работы для пользователя

Как работает

  1. Для API-подобных workflow: подключить error output каждого ненадёжного узла (HTTP, DB, API) к Respond to Webhook, чтобы избежать таймаутов у вызывающей стороны.
  2. Настроить код статуса ответа: 4xx для ошибок вызывающей стороны, 5xx для ошибок платформы; избегать возврата 200 на ветке ошибки.
  3. Для автономных workflow (плановых, очередей): установить workflow-level error workflow через update_workflow setWorkflowSettings.errorWorkflow.
  4. Целевой workflow для ошибок должен быть опубликован и содержать активный Error Trigger, иначе обновление будет отклонено.

Примеры запросов агенту

Настрой обработку ошибок для вебхука, чтобы вызывающая сторона получала корректный статус 5xx при сбое ноды.
Создай workflow-level error workflow для планового задания, которое запускается по расписанию.
Подключи error output HTTP-ноды к Respond to Webhook, чтобы избежать таймаута у клиента.

Что понадобится

  • n8n версии 2.29.0 или выше (для использования setWorkflowSettings.errorWorkflow)
  • Опубликованный workflow с активным Error Trigger (для workflow-level обработки)

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «n8n-error-handling» из репозитория: # https://github.com/n8n-io/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r n8n-error-handling/ ~/.claude/skills/n8n-error-handling/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.