n8n нейросеть: как пользоваться платформой и подключить ИИ-агента

n8n нейросеть превращает в рабочего помощника: вы собираете цепочку узлов, где один узел ловит событие, а второй — ИИ-агент — отвечает, классифицирует или генерирует текст. Платформа с открытым исходным кодом даёт визуальный холст, более 400 интеграций и встроенные AI-узлы. Ниже — установка, первый запуск и сборка чат-бота с моделью.

Что даёт n8n вместе с нейросетью

n8n — платформа автоматизации рабочих процессов: на холсте вы соединяете узлы (nodes) в цепочку (workflow) и получаете работающий сценарий без написания кода. Узлы делятся на триггеры — они запускают процесс по событию — и действия, которые это событие обрабатывают. Встроенные AI-агенты и поддержка RAG позволяют ставить нейросеть внутрь такой цепочки.

Схема простейшего сценария: триггер «пришло сообщение в чат» передаёт текст ИИ-агенту, к агенту подключён модуль модели OpenAI, и ответ возвращается пользователю. Всё это собирается перетаскиванием двух-трёх узлов. Дополнительно к модулю модели нужно добавить токен — ключ доступа к провайдеру.

Установка n8n через npm

Самый быстрый локальный путь — глобальная установка через npm. Перед этим нужен Node.js: скачайте последнюю LTS-версию с официального сайта nodejs.org и установите её.

Шаг 1. Проверьте Node.js и npm

Откройте терминал (в Windows — PowerShell) и проверьте, что установщик всё подхватил. Каждую команду выполняйте отдельно:

bash
node -v
bash
npm -v

Если обе команды вернули номер версии — можно двигаться дальше.

Шаг 2. Установите n8n глобально

Флаг -g ставит пакет глобально: после этого n8n запускается из любой директории, а не только из папки проекта.

bash
npm install n8n -g

Шаг 3. Запустите сервис

bash
n8n

В терминале появится сообщение о старте: n8n поднимается на порту 5678.

bash
n8n start

Команда n8n start делает то же самое, если вы привыкли к явному указанию действия. Остановить процесс можно сочетанием клавиш прерывания в терминале (Ctrl+C).

Первый вход и знакомство с интерфейсом

После запуска откройте адрес, который n8n вывел в терминале (локально это порт 5678). На стартовой странице задайте логин и пароль — это учётная запись для входа в ваш экземпляр.

На главной странице вы увидите рабочие процессы, сохранённые логины и пароли, лог выполнения запусков и Data Tables — внутреннее хранилище n8n. Для старта нужна кнопка создания нового workflow: она открывает пустой холст, где на правой панели кнопкой «+» добавляются узлы.

Из чего состоит рабочий процесс

  • Workflow — последовательность узлов на холсте, каждая такая цепочка работает независимо от других.
  • Node — модуль с настройками: триггер, действие, трансформация данных или код.
  • Item — единица данных, которая «плывёт» между узлами; workflow оперирует массивом таких элементов.
  • Credentials — защищённое хранилище ключей и логинов для внешних сервисов, значения шифруются.
  • Execution — результат запуска: логи, входные и выходные данные, ошибки.

Как собрать первый workflow с нейросетью

Сценарий-минимум — чат-бот на двух узлах. Триггер ловит сообщение, ИИ-агент его обрабатывает и отвечает.

Шаг 1. Создайте workflow и добавьте триггер

Нажмите кнопку создания нового workflow, затем «+» на правой панели и выберите триггер. Для чата подойдёт chat trigger — он срабатывает, когда вы отправляете сообщение во встроенный чат n8n. Другие частые триггеры: telegram trigger, запуск по расписанию (schedule) и события в подключённых приложениях, например новое письмо.

Шаг 2. Добавьте узел AI Agent

Вторым узлом поставьте действие — AI-агента. Соедините выход триггера со входом агента: теперь текст сообщения будет попадать в нейросеть как входные данные.

Шаг 3. Подключите модель и токен

К агенту присоединяется модуль модели — например, OpenAI. В настройках модуля создайте credentials и вставьте туда свой API-токен провайдера. Ключ хранится зашифрованным и не дублируется в тексте workflow.

Шаг 4. Проверьте выполнение

Отправьте тестовое сообщение в чат n8n. Результат каждого запуска сохраняется как execution: там видны входные данные, ответ модели и текст ошибки, если что-то пошло не так. По умолчанию n8n хранит историю выполнений, поэтому в рабочем проекте стоит заранее настроить срок её хранения.

Как передавать данные между узлами

Внутри параметров узла можно писать выражения — они подставляют реальные значения из данных, которые пришли на вход. Синтаксис — двойные фигурные скобки:

plain
{{ $json["email"] }}
plain
{{ $node["HTTP Request"].json["data"] }}

Первое выражение берёт поле из данных предыдущего узла, второе — из конкретного узла по имени. В узле Code доступны свои переменные: так получают все входные элементы, а так — результат уже отработавшего узла.

javascript
const inputs = $input.all();
javascript
const allData = $node['HTTP Request'].item;

Узел HTTP Request пригодится, когда нужно обратиться к внешнему API нейросети напрямую. Он поддерживает методы GET, POST, PUT, PATCH и DELETE, заголовки, query-параметры, авторизацию Bearer и Basic, тело в JSON, raw и form.

Типичные ошибки новичка

  • Node.js не установлен. Команды node -v и npm -v не отвечают — сначала поставьте LTS-версию с nodejs.org, потом возвращайтесь к npm.
  • n8n поставлен без флага `-g`. Тогда запуск работает только из папки установки; глобальная установка решает это.
  • Забыли токен у модуля модели. Агент добавлен, цепочка соединена, но ответа нет: проверьте credentials модуля модели.
  • Путаница Test URL и Prod URL. Вебхук в режиме отладки ловит запросы только по тестовому адресу.
  • Расчёт на встроенный REST API. Он недоступен в бесплатной версии — для программного управления нужен платный план.
  • Разрастающаяся история выполнений. В продакшене задайте retention, иначе база будет расти вместе с каждым запуском.

FAQ

Нужно ли уметь программировать, чтобы работать с нейросетью в n8n?

Нет. Базовая цепочка «триггер — AI-агент — модель» собирается перетаскиванием узлов. Код (на JavaScript или Python в узле Code) нужен только для нестандартной обработки данных.

Где n8n хранит ключи доступа к моделям?

В credentials — отдельном хранилище учётных данных. Значения шифруются и не попадают в текст workflow, поэтому один и тот же ключ можно переиспользовать в разных сценариях.

Можно ли запускать n8n не на своём компьютере?

Да. Платформа self-hosted, поэтому её разворачивают на сервере или в контейнере Docker; существует и облачный вариант. Локальный запуск через npm удобен для первых экспериментов.

Как понять, почему ИИ-агент не ответил?

Откройте лог выполнения (execution) последнего запуска: там сохраняются входные данные, ответ и текст ошибки. Чаще всего причина — отсутствующий или неверный токен в credentials модуля модели.

Работает ли n8n с моделями помимо OpenAI?

Да, к агенту подключаются модули разных провайдеров. В статье-обзоре упоминаются прокси-подключения к OpenAI, Gemini, Grok и Claude — конкретный набор зависит от выбранного модуля в вашей версии.

Источники

  • https://github.com/n8n-io/n8n
  • https://habr.com/ru/companies/amvera/articles/912560/
  • https://habr.com/ru/articles/962852/