ai
n8n AI агент — создание ИИ-агента с инструментами | Руководство
n8n AI агент: полное руководство
Создайте интеллектуального AI-агента на n8n с доступом к инструментам. От простого RAG-бота до автономного агента, способного выполнять сложные задачи.
Что такое AI-агент
AI-агент — это автономная система на базе большой языковой модели (LLM), которая способна не только генерировать текст, но и выполнять действия во внешнем мире. В отличие от простого чат-бота, агент может:
Искать информацию
Обращаться к поисковым системам, базам данных, API
Использовать инструменты
Вызывать функции, создавать записи, отправлять сообщения
Планировать действия
Разбивать сложные задачи на шаги и выполнять последовательно
Принимать решения
Анализировать результаты и корректировать стратегию
Пример работы AI-агента
Запрос пользователя: "Найди информацию о последних обновлениях n8n и создай сводку в Notion"
Действия агента:
- Ищет в интернете "n8n changelog 2025"
- Анализирует найденную информацию
- Формирует структурированную сводку
- Создаёт страницу в Notion через API
- Возвращает ссылку на созданную страницу
AI-возможности n8n
n8n активно развивает интеграции с искусственным интеллектом. Вот ключевые компоненты:
Встроенные AI-ноды
AI Agent
Центральная нода для создания агентов. Поддерживает подключение инструментов, память, различные стратегии рассуждений.
Chat Model
Подключение LLM: OpenAI, Anthropic, Google, Ollama, Azure OpenAI и другие.
Tool
Создание кастомных инструментов для агента: HTTP-запросы, работа с БД, n8n workflow.
Memory
Различные типы памяти: Buffer, Window, Summary, Vector Store.
Vector Store
Интеграции с Pinecone, Qdrant, Supabase, Chroma для RAG.
Embeddings
Генерация эмбеддингов через OpenAI, Cohere, локальные модели.
Поддерживаемые LLM-провайдеры
Простой агент (без инструментов)
Начнём с базового агента, который просто отвечает на вопросы. Это поможет понять структуру:
Структура workflow
Настройка AI Agent
- Добавьте ноду Chat Trigger (или Telegram Trigger)
- Подключите ноду AI Agent
- В AI Agent подключите Chat Model (например, OpenAI Chat Model)
- Настройте System Prompt
Ты — умный AI-ассистент компании AIBot.Direct.
Твои задачи:
- Отвечать на вопросы об автоматизации бизнеса
- Помогать с выбором решений
- Консультировать по n8n и ИИ-технологиям
Правила:
- Отвечай кратко и по делу
- Если не знаешь ответа — честно скажи
- При необходимости уточняй вопрос
- Используй русский язык
Подключение Memory
Чтобы агент помнил контекст разговора, добавьте Memory:
- В AI Agent нажмите "Add Memory"
- Выберите тип памяти:
- Buffer Memory — хранит все сообщения (потребляет много токенов)
- Window Memory — последние N сообщений (рекомендуется)
- Summary Memory — сжимает историю в резюме
- Настройте Session ID для разделения пользователей
Session ID
Используйте уникальный идентификатор пользователя как Session ID. Для Telegram: {{ $json.message.chat.id }}. Это позволит каждому пользователю иметь отдельную историю.
RAG-агент с базой знаний
RAG (Retrieval-Augmented Generation) — техника, при которой агент сначала ищет релевантную информацию в базе знаний, а затем использует её для генерации ответа. Это позволяет агенту отвечать на вопросы по вашим документам.
Архитектура RAG в n8n
Индексация
Документы → Chunks → Embeddings → Vector Store
Поиск
Query → Embedding → Similar Vectors → Relevant Chunks
Генерация
Query + Context → LLM → Answer
Шаг 1: Создание базы знаний
Создайте отдельный workflow для индексации документов:
Или Schedule для автообновления
Загрузка документов (PDF, TXT, MD)
Разбиение на chunks (500-1000 токенов)
OpenAI / Cohere / Ollama
Pinecone / Qdrant / Supabase
Шаг 2: Настройка агента с RAG
- В AI Agent добавьте Vector Store Tool
- Подключите тот же Vector Store, что использовали для индексации
- Настройте описание инструмента:
Используй этот инструмент для поиска информации в базе знаний компании.
База содержит: документацию по продуктам, FAQ, инструкции, прайс-листы.
Вызывай инструмент когда пользователь спрашивает о:
- Ценах и тарифах
- Функциях продуктов
- Технических деталях
- Процессах и инструкциях
Выбор Vector Store
Pinecone
Облачный, быстрый, простая настройка. Платный (есть free tier).
Рекомендуется для productionQdrant
Open-source, можно self-host. Бесплатный при self-hosted.
Для приватности данныхSupabase
PostgreSQL + pgvector. Полноценная БД + вектора.
Универсальное решениеАгент с инструментами (Function Calling)
Самое мощное применение AI-агентов — возможность использовать инструменты для взаимодействия с внешним миром.
Типы инструментов в n8n
HTTP Request Tool
Вызов любого API: погода, курсы валют, внешние сервисы.
Tool: get_weather
Description: Получить погоду в городе
Input: city (string)
Code Tool
Выполнение JavaScript-кода: вычисления, обработка данных.
Tool: calculate
Description: Выполнить математические вычисления
Input: expression (string)
Workflow Tool
Вызов других n8n workflow как инструментов.
Tool: create_crm_deal
Description: Создать сделку в CRM
Input: name, phone, comment
Vector Store Tool
Поиск по базе знаний (RAG).
Tool: search_docs
Description: Поиск в документации
Input: query (string)
Пример: Агент для продаж недвижимости
Создадим агента, который может:
- Искать объекты в базе недвижимости
- Записывать клиента на просмотр
- Создавать сделку в CRM
- Отвечать на вопросы по объектам
// Tool 1: Поиск объектов
{
name: "search_properties",
description: "Поиск объектов недвижимости по параметрам",
parameters: {
type: "object",
properties: {
city: { type: "string", description: "Город" },
rooms: { type: "number", description: "Количество комнат" },
max_price: { type: "number", description: "Максимальная цена" },
property_type: {
type: "string",
enum: ["apartment", "house", "commercial"],
description: "Тип объекта"
}
},
required: ["city"]
}
}
// Tool 2: Запись на просмотр
{
name: "schedule_viewing",
description: "Записать клиента на просмотр объекта",
parameters: {
type: "object",
properties: {
property_id: { type: "string" },
client_name: { type: "string" },
client_phone: { type: "string" },
preferred_date: { type: "string" }
},
required: ["property_id", "client_name", "client_phone"]
}
}
// Tool 3: Создание сделки
{
name: "create_deal",
description: "Создать сделку в CRM",
parameters: {
type: "object",
properties: {
client_name: { type: "string" },
phone: { type: "string" },
interest: { type: "string" },
budget: { type: "number" }
},
required: ["client_name", "phone"]
}
}
System Prompt для агента продаж
Ты — виртуальный помощник агентства недвижимости "Премиум Риэлт".
ТВОИ ЗАДАЧИ:
1. Помогать клиентам найти подходящую недвижимость
2. Отвечать на вопросы об объектах
3. Записывать на просмотры
4. Квалифицировать лиды
ИНСТРУКЦИИ:
- Всегда начинай с уточнения потребностей клиента
- При поиске объектов используй инструмент search_properties
- Предлагай 2-3 наиболее подходящих варианта
- Если клиент заинтересован — предложи записаться на просмотр
- После записи создай сделку в CRM
СТИЛЬ ОБЩЕНИЯ:
- Дружелюбный, но профессиональный
- Краткие, информативные ответы
- Задавай уточняющие вопросы
- Не будь навязчивым
ВАЖНО:
- Не выдумывай информацию об объектах — используй только данные из поиска
- Если нет подходящих объектов — честно скажи и предложи расширить критерии
Продвинутые паттерны
ReAct (Reasoning + Acting)
Паттерн, при котором агент чередует рассуждения и действия:
Thought: Пользователь спрашивает о погоде в Москве. Нужно использовать инструмент get_weather.
Action: get_weather(city="Москва")
Observation: Температура: +5°C, облачно
Thought: Получил данные о погоде. Могу ответить пользователю.
Answer: Сейчас в Москве +5°C, облачно.
Plan and Execute
Для сложных задач агент сначала составляет план, затем выполняет шаги:
- Анализ задачи
- Декомпозиция на подзадачи
- Последовательное выполнение
- Проверка результата
- Корректировка при необходимости
Multi-Agent Systems
Несколько агентов работают вместе, каждый со своей специализацией:
Orchestrator
Координирует работу
Research Agent
Поиск информации
Writer Agent
Генерация текста
Critic Agent
Проверка качества
Best Practices
1. Чёткие описания инструментов
LLM выбирает инструмент на основе описания. Пишите конкретно: когда использовать, какие параметры, что возвращает.
2. Ограничение инструментов
Не давайте агенту слишком много инструментов (оптимально 5-10). Чем больше выбор, тем чаще ошибки.
3. Логирование
Сохраняйте все вызовы инструментов и ответы. Это поможет отладить проблемы и улучшить промпты.
4. Обработка ошибок
Инструменты могут падать. Добавьте fallback-логику и информативные сообщения об ошибках для агента.
5. Лимиты итераций
Установите максимальное количество шагов агента (10-20), чтобы избежать бесконечных циклов и перерасхода токенов.
6. Подтверждение действий
Для критических операций (создание сделок, отправка писем) добавьте подтверждение от пользователя.
Безопасность AI-агентов
Важные меры безопасности
- Валидация входных данных — не доверяйте тому, что генерирует LLM
- Принцип минимальных привилегий — агент должен иметь только необходимые права
- Rate limiting — ограничьте частоту вызовов инструментов
- Sandbox — выполняйте код в изолированной среде
- Аудит — логируйте все действия для последующего анализа
Часто задаваемые вопросы
= $item['answer'] ?>
Частые вопросы
AI-агент в n8n — это автономная система на базе LLM, которая не только генерирует текст, но и выполняет действия: ищет информацию, вызывает инструменты, планирует шаги сложных задач и принимает решения на основе результатов.
Обычный чат-бот отвечает на вопросы по шаблонам. AI-агент в n8n может самостоятельно обращаться к поисковым системам, базам данных, API, создавать записи в CRM, отправлять сообщения и итеративно корректировать стратегию на основе промежуточных результатов.
RAG-агент (Retrieval-Augmented Generation) — агент с доступом к базе знаний. Перед ответом он ищет релевантные фрагменты из ваших документов и отвечает на их основе, а не выдумывает. Это устраняет галлюцинации при работе с корпоративными данными.
Агент с инструментами (Tools Agent) в n8n может вызывать любые ноды как инструменты: HTTP-запросы, SQL-запросы к базе данных, Telegram, Google Sheets, email и 400+ других интеграций. LLM сам решает, какой инструмент применить для задачи.
n8n поддерживает OpenAI (GPT-4o, GPT-5.x), Anthropic Claude, Google Gemini, Яндекс GPT и локальные модели через Ollama. Переключение между провайдерами не требует переписывания логики агента.
Продвинутые паттерны включают: мультиагентные системы (один агент вызывает других), Human-in-the-Loop (агент ждёт одобрения перед критическим действием), параллельное выполнение задач и агенты с долгосрочной памятью через векторную базу.
Да. Простые агенты создаются визуально через drag-and-drop: нода AI Agent → нода LLM → ноды инструментов. Для продвинутых сценариев доступен JavaScript и Python прямо в нодах. Базовый агент — без единой строки кода.
Нужна ИИ-автоматизация под ваш бизнес?
Запишитесь на бесплатную консультацию — обсудим задачу и пришлём готовое решение.
Обсудить проект →