- Из чего состоит агент в n8n
- Шаг 1. Создайте сценарий с чат-триггером
- Шаг 2. Добавьте узел AI Agent
- Шаг 3. Подключите модель
- Шаг 4. Добавьте память
- Шаг 5. Подключите инструменты
- Шаг 6. Напишите системный промт
- Шаг 7. Протестируйте в чате
- Шаг 8. Подключите агента к Telegram
- Готовые шаблоны агентов
- Частые ошибки
- Частые вопросы
- Можно ли сделать агента в n8n бесплатно?
- Какие типы агентов есть в n8n?
В n8n ИИ-агент — это узел AI Agent, к которому снизу подключаются модель, память и инструменты. Агент получает сообщение, сам решает, какой инструмент вызвать (найти в таблице, сделать HTTP-запрос, посчитать), и возвращает ответ. Ниже — сборка агента с нуля и разбор каждой настройки. Если n8n ещё не установлен, начните со статьи n8n: что это и как установить.
Из чего состоит агент в n8n
| Элемент | Обязателен | Что делает |
|---|---|---|
| Триггер (Chat Trigger, Telegram Trigger, Webhook) | Да | Передаёт агенту входящее сообщение |
| AI Agent | Да | Управляет рассуждением: выбирает инструменты и формирует ответ |
| Chat Model | Да | Языковая модель — облачная или локальная |
| Tool | Да, хотя бы один | Действия агента: таблицы, HTTP-запросы, другие сценарии, MCP-серверы |
| Memory | Нет, но почти всегда нужна | Помнит предыдущие сообщения диалога |
Шаг 1. Создайте сценарий с чат-триггером
- В n8n нажмите Create workflow (или «+» в левой панели).
- Нажмите Add first step и найдите Chat Trigger («When chat message received»). Этот триггер добавляет окно чата прямо в редактор — удобно для тестов.
Шаг 2. Добавьте узел AI Agent
- Нажмите «+» справа от триггера и найдите AI Agent.
- В поле Source for Prompt оставьте вариант, при котором текст берётся из чат-триггера автоматически.
- Под узлом появятся три разъёма: Chat Model, Memory и Tool.
Шаг 3. Подключите модель
Нажмите «+» под разъёмом Chat Model и выберите провайдера. Варианты:
- OpenAI, Anthropic, Google Gemini, Mistral, Groq, OpenRouter — нужен API-ключ провайдера, который вставляется в Credentials.
- Ollama Chat Model — локальная модель на вашем компьютере. В учётных данных укажите адрес
http://localhost:11434(если n8n в Docker —http://host.docker.internal:11434). Как поставить Ollama — в отдельной инструкции. - Российские модели (GigaChat, YandexGPT) подключаются через совместимые с OpenAI адреса API или через инструмент HTTP Request — смотрите документацию конкретного провайдера.
Для агента выбирайте модель, которая умеет вызывать инструменты. Маленькие локальные модели (до 8b) часто путаются в инструментах — берите 14b и больше.
Шаг 4. Добавьте память
Под разъёмом Memory выберите Simple Memory. Она хранит последние сообщения диалога (по умолчанию несколько последних пар) отдельно для каждого чата. Для долгой памяти между перезапусками используйте Postgres Chat Memory или Redis Chat Memory.
Шаг 5. Подключите инструменты
Каждый инструмент — отдельный подузел под разъёмом Tool. Самые полезные:
| Инструмент | Пример задачи |
|---|---|
| Google Sheets Tool | Найти ответ в таблице частых вопросов или записать заявку |
| HTTP Request Tool | Узнать статус заказа через API вашего сервиса, курс валют, погоду |
| Call n8n Workflow Tool | Запустить другой ваш сценарий как действие агента (например, «создать счёт») |
| Calculator, Code Tool | Точные вычисления, которые модели делают с ошибками |
| MCP Client Tool | Подключить MCP-сервер сервиса и сразу получить набор его действий |
У каждого инструмента заполните Description: короткое описание того, когда его вызывать («Используй, чтобы найти цену товара по названию»). По этому описанию агент решает, нужен ли инструмент.
Шаг 6. Напишите системный промт
В узле AI Agent откройте Options → System Message. Пример для агента поддержки:
Ты - консультант онлайн-школы английского языка.
Задача: отвечать на вопросы о курсах, ценах и расписании.
Ищи информацию только инструментом "Курсы" (Google Sheets).
Если ответа нет в таблице - так и скажи и предложи оставить телефон.
Не обещай скидок и не называй цен, которых нет в таблице.
Отвечай кратко, до 5 предложений, на русском.Чтобы не писать промт с нуля, соберите его в конструкторе промтов.
Шаг 7. Протестируйте в чате
- Нажмите кнопку Open chat внизу редактора.
- Задайте вопрос и смотрите, как подсвечиваются узлы: какие инструменты агент вызвал и что они вернули.
- Если ответ неверный, откройте выполнение (Executions) и найдите шаг, где агент ошибся: не вызвал инструмент, вызвал не тот или неправильно понял результат.
- Правьте описания инструментов и промт, затем повторите тест.
Шаг 8. Подключите агента к Telegram
- Создайте бота у @BotFather и получите токен.
- Замените Chat Trigger на Telegram Trigger (событие «Message») и создайте учётные данные с токеном.
- В AI Agent укажите источник текста: выражение с полем
message.textиз триггера. - Для памяти задайте ключ сессии — ID чата из Telegram, чтобы у каждого собеседника была своя история.
- После AI Agent добавьте узел Telegram → Send Message: Chat ID — из триггера, Text — поле
outputагента. - Включите сценарий переключателем Active.
Важно: Telegram Trigger работает через вебхук, поэтому n8n должен быть доступен из интернета по HTTPS. На домашнем компьютере без белого адреса это не заработает — нужен сервер или туннель.
Готовые шаблоны агентов
В каталоге n8n.io/workflows тысячи готовых сценариев с ИИ: агенты поддержки, ассистенты для почты, парсеры, генераторы контента. Шаблон импортируется в ваш n8n одной кнопкой — останется только подставить свои учётные данные.
Частые ошибки
| Ошибка | Причина и решение |
|---|---|
| Агент не вызывает инструмент | Пустое или размытое Description инструмента; слабая модель. Опишите конкретно, когда вызывать, или смените модель |
| Агент «забывает» начало разговора | Не подключена память или у Telegram-чатов один и тот же ключ сессии |
| Ошибка подключения к Ollama | n8n в Docker не видит localhost компьютера — используйте адрес host.docker.internal |
| Ответы выдуманы | В промте нет запрета выдумывать и требования брать данные только из инструмента |
| Сценарий из Telegram не срабатывает | Сценарий не активирован или n8n недоступен по HTTPS из интернета |
Частые вопросы
Можно ли сделать агента в n8n бесплатно?
Да: n8n Community на своём компьютере или сервере и локальная модель через Ollama. Платить придётся только за сервер, если агент должен работать круглосуточно.
Какие типы агентов есть в n8n?
Раньше в узле AI Agent выбирался тип агента. Начиная с версии 1.82 все агенты работают как Tools Agent — агент с инструментами. Старую версию узла уберут в n8n 3.0, поэтому в старых сценариях стоит обновить узел.
