# n8n нейросеть: как пользоваться платформой и подключить ИИ-агента
Каноническая страница: https://plainews.ru/posts/n8n-neyroset-kak-polzovatsya
Опубликовано: 2026-10-29T06:41:27.751Z

Пошаговый гайд по n8n: установка через npm, запуск на порту 5678, сборка workflow с ИИ-агентом, подключение модели OpenAI и разбор типичных ошибок.
# 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 можно и в Docker — официальный образ n8n есть в репозитории проекта. Для локального старта без контейнеров хватает npm-команд выше.

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

После запуска откройте адрес, который 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.

> **Важно.** Входящие вебхуки дают два адреса — Test URL и Prod URL. Тестовый работает, пока вы отлаживаете сценарий; для постоянной работы внешний сервис должен обращаться к продакшен-адресу.

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

- **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/