Как реализовать workflow в n8n

Инструкция от команды разработки корпоративного n8n https://books.ide-spb.com/books/ii-transformaciia/page/vvodnyi-kurs-po-n8n-telegram-bot-dlia-transkripcii-vstrec.

Статья-кейс использования https://habr.com/ru/companies/sovcombank_technologies/articles/1027594/
Обучающий ролик на rutube https://rutube.ru/video/a0cc2ded8a012e6d89f8b12c869b545c,
youtube https://www.youtube.com/watch?v=5nHtQ1gCyKo&t=195s.

Доступ к n8n

Корпоративная n8n платформа располагается по адресу https://n8n.geotech.user.events/

Вход в n8n выполняется через SSO (или по паролю). Далее авторизация доменная.

1. Создание workflow вручную

Workflow можно создать вручную из готовых блоков - нод.

Разберём на примере - чат с моделью Gemini 3.7 Flash.

Пользователь открывает чат по ссылке, задаёт вопрос, а модель geotech/gemini/gemini-3.7-flash отвечает в том же окне. Этот же workflow можно не собирать вручную, а импортировать из готового JSON — см. раздел 2.

Workflow состоит из трёх нод:

Общий порядок действий:

Шаг 1. Создайте workflow

1. Нажмите кнопку "Create workflow".

2. Задайте название workflow, например Чат с Gemini 3.7 Flash. Название меняется кликом по нему в верхней части экрана.

Шаг 2. Добавьте ноду «Чат с пользователем» (Chat Trigger)

Это стартовая нода: workflow запускается каждый раз, когда пользователь отправляет сообщение в чат.

1. Нажмите + на рабочем поле.

2. В строке поиска введите Chat Trigger и выберите "On new chat event".

3. Настройте параметры:

Make Chat Publicly Available — включить. Тогда у чата появится ссылка, которую можно открыть в браузере;

Mode — Hosted Chat;

Authentication — None;

Initial Message(s)— приветствие, например Здравствуйте! Задайте вопрос;

Options → Response Mode — Using Response Nodes. Так ответ в чат будет отправлять отдельная нода «Ответ в чат».

4. Переименуйте ноду в Чат с пользователем (клик по названию ноды или клавиша F2).

Важно: при Authentication = None чатом может воспользоваться любой, у кого есть ссылка. Если чат должен быть доступен только сотрудникам, выберите n8n User Auth или Basic Auth.

Шаг 3. Добавьте ноду «Спросить модель» (OpenAI)

1. Нажмите + справа от ноды «Чат с пользователем».

2. В строке поиска введите OpenAI и выберите действие "Message a model".

3. Настройте параметры:

Credential to connect with — OpenAi account 2 (подробнее — в разделе «Credentials в примере» ниже);

Resource — Text;

Operation — Message a Model;

Model — From list→ geotech/gemini/gemini-3.7-flash;

Messages → Prompt — текст запроса к модели:

Ответь кратко и по делу на русском языке.

Вопрос:

{{ $json.chatInput }}

{{ $json.chatInput }} — это выражение (expression), в которое n8n подставляет текст, введённый пользователем в чат. Оно должно подсвечиваться как на изображении.
Чтобы выражение работало, поле Prompt должно быть в режиме Expression, а не Fixed. Выражение можно не печатать вручную, а перетащить поле chatInput из панели входных данных (INPUT) слева.

Отеть кратко и по делу на русском языке.

4. Переименуйте ноду в Спросить модель.

Шаг 4. Добавьте ноду «Ответ в чат» (Edit Fields)

1. Нажмите + справа от ноды «Спросить модель».

2. В строке поиска введите Edit Fields и выберите ноду.

3. Настройте параметры:

• Mode — Manual Mapping;

• Fields to Set — нажмите "Add Field" и заполните:

• Name — output;

• Type — String;

• Value — выражение (режим Expression):

{{ $json.output[0].content[0].text }}

4. Переименуйте ноду в Ответ в чат.

Шаг 5. Сохраните и проверьте workflow

1. Сохраните workflow сочетанием клавиш Ctrl + S, версия любая.

2. Нажмите кнопку "Open chat" внизу рабочего поля.

3. Напишите вопрос, например Что такое n8n?, нажмите Enter или значок отправки и дождитесь ответа.

4. Если ответ пришёл — workflow работает. Все ноды должны подсветиться зелёным.

Шаг 6. Откройте чат по ссылке

1. Откройте ноду «Чат с пользователем».

2. Скопируйте ссылку из поля Chat URL.

3. Активируйте workflow (кнопка Publish в верхней части экрана, в зависимости от версии n8n). Без активации ссылка работать не будет.

4. Откройте ссылку в браузере или передайте её коллегам.

[Скриншот: Chat URL в ноде Chat Trigger и активированный workflow]

Credentials в примере

В примере используется один credential — OpenAi account 2. Он выбирается в ноде «Спросить модель». Ноды «Чат с пользователем» и «Ответ в чат» credentials не требуют.

Несмотря на название, этот credential подходит не только для моделей OpenAI. Через него доступны все LLM-модели и модели генерации изображений из раздела «Доступные модели» — в том числе geotech/gemini/... и geotech/anthropic/.... Поэтому для смены модели достаточно поменять поле Model, credential менять не нужно.

Credential OpenAi account 2 общий: его не нужно создавать самостоятельно, он находится во вкладке "Shared with you".

Что такое credentials, какие ещё credentials есть на корпоративном n8n и что делать, если нужного доступа нет, описано в инструкции n8n. Доступы или credentials.

Что можно поменять

• Инструкцию для модели — текст в поле Prompt ноды «Спросить модель». Например, попросить модель отвечать в определённом стиле, формате или только на определённые темы. Строку {{ $json.chatInput }} удалять нельзя — иначе модель не получит вопрос пользователя.

• Модель — поле Model в ноде «Спросить модель». Можно выбрать любую LLM-модель из раздела «Доступные модели», например geotech/openai/gpt-4o-mini или geotech/anthropic/claude-sonnet-4-6.

• Приветствие — поле Initial Message(s) в ноде «Чат с пользователем».

Если после смены модели ответ в чате пустой или workflow падает на ноде «Ответ в чат», откройте выходные данные (OUTPUT) ноды «Спросить модель» и проверьте, где лежит текст ответа. У рассуждающих моделей (например, geotech/openai/o3, geotech/openai/gpt-5.4) первым элементом может идти блок рассуждений, и текст окажется не в output[0], а в output[1]. В этом случае поправьте выражение в ноде «Ответ в чат».

Если workflow выполнился с ошибкой

n8n показывает проблемную ноду красным цветом.

Чтобы посмотреть текст ошибки:

• откройте выполнение workflow;

• нажмите на красную ноду;

• откройте вкладку с ошибкой или output/error details;

• прочитайте поля Error message, Error details, Stack trace, Request или Response, если они доступны;

• проверьте, на каком шаге возникла ошибка и какие данные пришли в ноду.

Чаще всего по тексту ошибки можно понять причину:

• неверный путь к файлу;

• не выбраны credentials (как выбрать и что это такое — см. «Доступы / credentials»);

• нет доступа к Nextcloud;

• модель недоступна;

• запрос ушёл не в тот endpoint;

• входной файл пустой или имеет неправильный формат.

Если ошибка непонятна, её можно разобрать с помощью LLM-модели на ИИ-платформе.

Для этого: скопируйте текст ошибки из n8n и вставьте ошибку в чат с LLM-моделью на ИИ-платформе. Добавьте краткий контекст: какую ноду запускали, какой workflow, что ожидали получить. Попросите объяснить причину ошибки и предложить шаги исправления.

На корпоративном n8n доступны не все существующие ноды n8n, а только те, которые используются сотрудниками и соответствуют требованиям безопасного использования.

Если нужной ноды нет в списке, её можно обсудить или запросить через alsu.yarulina@areal.ru и или у команды отдела искусственного интеллекта.

2. Создание workflow с помощью json

Workflow в проекте хранятся как .json файлы. Их можно импортировать в n8n как файл.
Вы можете попробовать загрузить тестовый пример:

Общий порядок действий:

Импортируем тот же чат-бот, который в разделе 1 собирался вручную.

1. Скачайте файл Демо. chat_gemini-3.7-flash.json (прикреплён к инструкции).

2. Откройте n8n и нажмите "Create workflow".

3. В меню ... в правом верхнем углу выберите "Import from File" и укажите скачанный файл.

[Скриншот: меню импорта workflow из файла]

4. На рабочем поле появятся три ноды: «Чат с пользователем» → «Спросить модель» → «Ответ в чат», а также заметка «Заметка: что поменять» с подсказками.

[Скриншот: импортированный workflow]

5. Откройте ноду «Спросить модель» и проверьте поле Credential to connect with: там должен быть выбран OpenAi account 2. Если поле пустое или выделено красным — выберите OpenAi account 2 из списка вручную. Остальные две ноды credentials не требуют.

[Скриншот: credential OpenAi account 2 в ноде «Спросить модель»]

6. Сохраните workflow.

7. Workflow с чатом запускается не кнопкой Execute workflow, а через чат: нажмите "Open chat" внизу рабочего поля, напишите вопрос и дождитесь ответа.

8. Чтобы открыть чат по ссылке, выполните шаг 6 из примера в разделе 1.

Что означают настройки каждой ноды, какие параметры можно поменять и подробнее про credential OpenAi account 2 — см. пример в разделе 1. Про credentials в целом — в инструкции Доступы / credentials (Доступы_credentials.md).

Общие замечания по импорту

Почему после импорта n8n может быть необходимо заново выбрать credentials? Экспортированный JSON хранит ссылки на credentials, но в другой среде они могут не совпадать.

Иногда после загрузки workflow из JSON изменения не подтягиваются. В этом случае нужно:

1. Сохранить workflow;

2. Выйти из workflow;

3. Открыть его заново;

4. Проверить, что изменения (ноды, credentials) подтянулись корректно.

3. Как выгрузить workflow в JSON

Workflow можно не только импортировать, но и выгружать из n8n в формате .json.

Когда это нужно

• передать workflow другому пользователю;

• сохранить рабочую версию перед изменениями;

• использовать workflow как основу для другого проекта.

Шаги

• Откройте нужный workflow в n8n.

• Убедитесь, что последние изменения сохранены.

• Выберите экспорт workflow в JSON.

• Сохраните файл.

• Перед передачей проверьте, что в JSON нет секретов, токенов или приватных данных.

Credentials обычно не экспортируются полностью: в JSON остаются только ссылки на credentials. Поэтому после импорта в другой среде их часто нужно выбрать заново.

4. Доступные модели

Ниже приведён список моделей и их целевое назначение.

Транскрибация аудио

geotech/openai/whisper-1

LLM-модели

Эти модели подходят для генерации текста, анализа, классификации, суммаризации и ответов на вопросы.

geotech/anthropic/claude-haiku-4-5
geotech/anthropic/claude-opus-4-5
geotech/anthropic/claude-opus-4-6
geotech/anthropic/claude-sonnet-4-5
geotech/anthropic/claude-sonnet-4-6
geotech/gemini/gemini-2.5-flash
geotech/gemini/gemini-3-flash-preview
geotech/gemini/gemini-3.1-flash-lite
geotech/gemini/gemini-3.1-pro-preview
geotech/gemini/gemini-3.7-flash
geotech/nn-tech/MetalGPT-1
geotech/openai/gpt-4-turbo
geotech/openai/gpt-4.1
geotech/openai/gpt-4.1-nano
geotech/openai/gpt-4o
geotech/openai/gpt-4o-mini
geotech/openai/gpt-5-chat-latest
geotech/openai/gpt-5-nano
geotech/openai/gpt-5.2
geotech/openai/gpt-5.4
geotech/openai/gpt-5.4-mini
geotech/openai/gpt-5.4-nano
geotech/openai/gpt-5.4-pro
geotech/openai/o3
geotech/xai/grok-4-latest
geotech/zai-org/GLM-4.7-Flash

Генерация изображений

Эти модели используются для создания изображений по текстовому описанию.

geotech/openai/gpt-image-1.5
geotech/gemini/gemini-3-pro-image
geotech/gemini/gemini-3-pro-image-preview
geotech/gemini/gemini-3.1-flash-image

Эмбеддинги

Эти модели используются для преобразования текста в вектор. Они нужны для поиска текста по семантическому сходству, RAG и т.д.

geotech/openai/text-embedding-3-large
geotech/openai/text-embedding-3-small

Синтез речи

Эти модели используются для преобразования текста в аудио.

geotech/openai/tts-1
geotech/openai/tts-1-hd

5. Оставшиеся вопросы

Инструкция актуальна на момент написания (11.06.26), функционал корпоративного n8n (ноды, модели) постоянно пополняется. В том числе под конкретные задачи сотрудников.
По всем вопросам, задачам, которые Вы хотите реализовать в n8n, пишите alsu.yarulina@areal.ru или команде отдела искусственного интеллекта.

Дата обновления: 7 октября 2026