Начало работы с n8n: первый агент, ключи ИИ и подключение DeepSeek

n8n установлен, аккаунт администратора создан — что дальше? Почти все, ради чего ставят n8n в 2026 году, связано с ИИ: агенты, чат-боты, обработка текстов. В этой статье разберем первый экран n8n, выбор между агентом и сценарием, ключи к языковым моделям и подключение DeepSeek.

Статья написана для полной установки n8n — с песочницей, Python и веб-поиском, как в разделе «Полная установка n8n». Если у вас один контейнер n8n из быстрой установки, часть возможностей будет недоступна — об этом в последнем разделе.

Статья проверена в ноябре 2026 года на n8n 2.46.

Что сделать сразу после установки

• Получите бесплатный ключ Community Edition. Он открывает папки для сценариев, отладку в редакторе и пользовательские данные запусков. Как его получить — в разделе «Бесплатный ключ» статьи про установку.
• Включите двухфакторную аутентификацию, если панель n8n доступна из интернета: Settings → Personal.
• Проверьте часовой пояс. От него зависят сценарии по расписанию: в полной установке он задается строками GENERIC_TIMEZONE и TZ в файле ~/n8n/.env.

Первый экран: Build an agent или Build a workflow

После входа n8n предлагает начать с одного из двух вариантов — Let's build your first automation:

• Build an agent — создать Агента в конструкторе Agent Builder. Агент — отдельный объект в проекте, а не часть сценария: у него есть модель, инструкции, инструменты, память, база знаний, расписания и каналы (Telegram, Slack, Linear, Microsoft Teams). Его можно проверить в окне Preview и опубликовать кнопкой Publish.
• Build a workflow — открыть пустой холст и собрать сценарий из нод: триггер, обработка данных, интеграции. ИИ в сценарии подключается нодой AI Agent с дочерними нодами модели, памяти и инструментов.

Документация n8n отдельно предупреждает: Агент из Agent Builder и нода AI Agent — разные вещи. Агент живет сам по себе, а нода AI Agent работает только внутри сценария. Связать их можно: нода Message an Agent отправляет сообщение Агенту из любого сценария.

Что выбрать для начала:

• Чат-бот или помощник, который отвечает в мессенджере, ищет в интернете и пользуется вашими документами, — Build an agent. Это быстрее: не нужно собирать цепочку нод.
• Автоматизация с четкими шагами (заявка с сайта → CRM → уведомление) или ИИ как один шаг среди прочих — Build a workflow.

Где взять ключ к языковой модели

И Агенту, и нодам ИИ в сценариях нужен ключ к языковой модели. Ключ сохраняется один раз как учетные данные (Credentials) и дальше подключается к любым агентам и нодам этого провайдера. Основные варианты:

DeepSeek в Агенте (Build an agent)

1. Нажмите Build an agent (или в проекте откройте вкладку Agents → Create Agent) и задайте имя Агента.
2. На вкладке Agent откройте поле Model и выберите провайдера DeepSeek, затем модель. Если учетных данных DeepSeek еще нет, n8n предложит их создать — вставьте ключ (где взять ключ и какие есть модели — в разделе DeepSeek в помощнике).
3. В поле Instructions опишите, что должен делать Агент: его роль, стиль ответов, ограничения.
4. При необходимости добавьте инструменты (Tools → Add tool), включите поиск в интернете (Capabilities → Web search) и загрузите документы на вкладке Knowledge.
5. Проверьте Агента в окне Preview и нажмите Publish.

Поиск в интернете в полной установке работает через собственный SearXNG, а база знаний и выполнение кода — через песочницу. Подключение песочницы видно в Settings → Agents → Shared sandbox: ее используют и Агенты, и n8n Assistant.

DeepSeek в сценарии (Build a workflow)

1. В n8n откройте Overview → Credentials → Create credential, выберите DeepSeek и вставьте ключ (если вы уже создали его для Агента, этот шаг не нужен).
2. В сценарии подключите к ноде AI Agent (или Basic LLM Chain) ноду DeepSeek Chat Model и выберите эти учетные данные.
3. Выберите модель в поле Model — n8n загрузит список моделей, доступных вашему аккаунту.

Если аккаунта DeepSeek нет или хочется держать все модели на одном балансе, подключите DeepSeek через OpenRouter: создайте учетные данные OpenRouter, подключите к агенту ноду OpenRouter Chat Model и выберите модель DeepSeek из списка. Тот же ключ подойдет и для других моделей — можно сравнить DeepSeek с Claude или GPT, просто сменив модель в ноде.

n8n Assistant: помощник в редакторе

n8n Assistant — встроенный ИИ-помощник. Он умеет:

• собирать и править сценарии по текстовому описанию — вы пишете в чате, что нужно автоматизировать, а помощник добавляет и настраивает ноды;
• предлагать инструкции, инструменты и навыки для Агентов;
• разбирать упавшие запуски и предлагать исправления;
• отвечать на вопросы по n8n с учетом того, что открыто в редакторе.

Песочница в полной установке уже есть, поэтому помощнику нужен только ключ. Он задается в Settings → Assistant, на выбор четыре провайдера: Anthropic, OpenAI, OpenRouter и Self-hosted or OpenAI-compatible endpoint.

DeepSeek в помощнике (n8n Assistant)

DeepSeek — один из самых дешевых и сильных вариантов и для помощника, и для агентов: его модели поддерживают вызов инструментов (tool calling). Ключ один для всех мест в n8n:

1. На platform.deepseek.com откройте раздел API keys и нажмите Create new secret key.
2. Скопируйте ключ: второй раз его не покажут. Запросы списываются с баланса аккаунта (раздел Top up).

В API DeepSeek сейчас две модели: deepseek-flash (быстрая и дешевая, подходит для большинства задач) и deepseek-v4-pro (сильнее в сложных задачах, дороже).

Base URL — адрес API, куда n8n отправляет запросы. В учетных данных DeepSeek (для Агента и ноды DeepSeek Chat Model) оставьте значение по умолчанию https://api.deepseek.com: это OpenAI-совместимый адрес DeepSeek. Этот же адрес указывается и для помощника.

Отдельного пункта DeepSeek в списке провайдеров n8n Assistant нет, но API DeepSeek совместим с OpenAI, поэтому есть два пути.

Своим ключом DeepSeek. Выберите провайдера Self-hosted or OpenAI-compatible endpoint, укажите адрес https://api.deepseek.com и ключ DeepSeek. Через переменные окружения это N8N_INSTANCE_AI_MODEL_URL и N8N_INSTANCE_AI_MODEL_API_KEY. Учтите: в сообществе n8n сообщали, что при такой настройке запросы все равно уходили в OpenAI. Если помощник не отвечает, проверьте этот случай первым.

Через OpenRouter — вариант, который n8n приводит в документации. Добавьте строки в ~/n8n/.env и перезапустите контейнеры (docker compose up -d):

N8N_INSTANCE_AI_MODEL=openrouter/deepseek/deepseek-v4-pro
N8N_INSTANCE_AI_MODEL_API_KEY=ваш_ключ_OpenRouter

Если у вас минимальная установка

В быстрой установке из статьи про установку n8n работает один контейнер n8n — без песочницы, раннеров Python и SearXNG. Отсюда ограничения:

• n8n Assistant не работает, даже если ключ указан: он выполняет код в песочнице, а без нее не запускается.
• Агенты теряют часть возможностей: база знаний и выполнение кода тоже требуют песочницы, а для поиска в интернете нужен SearXNG или платный Brave Search.
• В ноде Code доступен только JavaScript, Python работает в отдельном контейнере runners.

Что работает без ограничений — сценарии (Build a workflow) и нода AI Agent: им нужен только ключ к модели. DeepSeek подключается так же, нодой DeepSeek Chat Model или через OpenRouter, как описано выше. Модель работает на стороне провайдера, поэтому мощный сервер не нужен.

Чтобы получить все возможности, есть два пути:

1. Перейти на полную установку. Ей нужен VPS от 2 vCPU и 4 GB RAM.
2. Подключить облачную песочницу Daytona (отдельный аккаунт): n8n рекомендует ее для рабочих серверов, если запускать контейнер с повышенными правами на своем сервере нежелательно.

Что дальше

Ключ подключен — можно собирать первого агента. Пошаговые примеры, от агента с калькулятором до Telegram-бота с памятью, — в статье ИИ-агенты в n8n. Если окажется, что n8n вам не подходит, посмотрите аналоги n8n.