Как создать ИИ-агента в n8n: пошаговая инструкция для начинающих

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

Что такое n8n простыми словами

n8n — это визуальный конструктор автоматизаций. Вместо написания программы Вы собираете на экране схему из блоков — Nodes. Каждый Node выполняет одно действие: принимает сообщение из Telegram, отправляет запрос в OpenAI, записывает строку в Google Sheets. Соединённые стрелками, эти блоки образуют workflow — рабочий сценарий, по которому данные движутся от события к результату.

Ключевые термины, которые Вам понадобятся:

• Workflow — весь сценарий агента целиком;
• Node — один блок-действие внутри workflow;
• Trigger — особый Node, запускающий workflow: новое сообщение, входящее письмо, расписание;
• Credentials — сохранённые ключи доступа к сервисам (подробно — в статье «Что такое Credentials в n8n»);
• Expression — выражение, подставляющее данные из одного Node в другой.

Что понадобится перед началом

• доступ к n8n (облачная версия n8n Cloud или собственная установка);
• Telegram-бот и его токен — создаётся за 5 минут через BotFather;
• аккаунт OpenAI API и API Key (обратите внимание: OpenAI API — это отдельный сервис, не подписка ChatGPT, и оплачивается отдельно).

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

Войдите в n8n и нажмите «New Workflow». Дайте ему понятное имя, например «Telegram AI Assistant». Перед Вами откроется пустое полотно, на которое мы будем добавлять Nodes.

Шаг 2. Добавьте Telegram Trigger

Первый блок любого агента — триггер. Добавьте Node Telegram Trigger и выберите событие «Message»: workflow будет запускаться каждый раз, когда пользователь пишет Вашему боту. Здесь n8n попросит указать Credentials — вставьте токен бота, полученный от BotFather. После сохранения n8n автоматически зарегистрирует Webhook, и Telegram начнёт передавать сообщения в Ваш workflow.

Шаг 3. Подключите OpenAI

Добавьте следующий Node — OpenAI (или Node «AI Agent» в новых версиях n8n). Создайте Credentials с Вашим API Key от OpenAI. В настройках Node:

1. выберите модель (для учебных задач подойдёт лёгкая недорогая модель);
2. в поле сообщения пользователя подставьте текст из Telegram с помощью Expression — например, {{ $json.message.text }};
3. в System Prompt опишите роль агента: «Ты — вежливый помощник компании. Отвечай кратко и по делу на русском языке».

System Prompt — это инструкция, которая управляет поведением модели. Именно здесь «характер» Вашего агента: тон, язык, ограничения, формат ответов.

Шаг 4. Верните ответ пользователю

Добавьте Node Telegram → Send Message. В поле Chat ID подставьте идентификатор чата из триггера, а в текст сообщения — ответ, полученный от OpenAI. Соедините блоки стрелками: Telegram Trigger → OpenAI → Telegram Send Message. Схема из трёх блоков — это уже полноценный ИИ-агент.

Шаг 5. Протестируйте и активируйте

Нажмите «Test Workflow» и отправьте сообщение своему боту в Telegram. В n8n Вы увидите, как данные проходят по цепочке: что пришло из Telegram, что ушло в OpenAI, что вернулось. Если всё работает — переключите workflow в режим Active. С этого момента агент работает постоянно и отвечает на сообщения без Вашего участия.

Типичные ошибки начинающих

• Ошибка 401 / Unauthorized — неверный или неактивный API Key. Проверьте Credentials и наличие средств на балансе OpenAI API.
• Бот не отвечает — workflow не активирован, либо токен бота указан неверно, либо тот же токен одновременно используется другим сервисом.
• Пустой ответ — Expression указывает не на то поле; откройте выполнение workflow и посмотрите реальную структуру данных.
• Слишком сложный первый проект — самая частая ошибка. Не начинайте с CRM, RAG и десятков Nodes: сначала один простой работающий workflow, затем следующий.

Как ускорить создание агентов с помощью ИИ

Собирать workflow вручную полезно для понимания, но современный подход ещё быстрее: Вы описываете идею в ChatGPT, получаете техническое задание, а Claude Code генерирует готовый JSON workflow, который импортируется в n8n за секунды. Вам остаётся подключить Credentials и протестировать. Этот подход называется Vibe Coding — и именно ему посвящён наш курс.