ai

n8n AI агент — создание ИИ-агента с инструментами | Руководство

n8n AI агент — создание ИИ-агента с инструментами | Руководство

n8n AI агент: полное руководство

Создайте интеллектуального AI-агента на n8n с доступом к инструментам. От простого RAG-бота до автономного агента, способного выполнять сложные задачи.

30 минут чтения Обновлено:

Что такое AI-агент

AI-агент — это автономная система на базе большой языковой модели (LLM), которая способна не только генерировать текст, но и выполнять действия во внешнем мире. В отличие от простого чат-бота, агент может:

Искать информацию

Обращаться к поисковым системам, базам данных, API

Использовать инструменты

Вызывать функции, создавать записи, отправлять сообщения

Планировать действия

Разбивать сложные задачи на шаги и выполнять последовательно

Принимать решения

Анализировать результаты и корректировать стратегию

Пример работы AI-агента

Запрос пользователя: "Найди информацию о последних обновлениях n8n и создай сводку в Notion"

Действия агента:

  1. Ищет в интернете "n8n changelog 2025"
  2. Анализирует найденную информацию
  3. Формирует структурированную сводку
  4. Создаёт страницу в Notion через API
  5. Возвращает ссылку на созданную страницу

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-провайдеры

OpenAI GPT-5.1, GPT-5, GPT-4o
Anthropic Claude Opus 4.5, Sonnet 4.5, Haiku 4.5
Google Gemini 3 Pro, Gemini 3 Flash
xAI Grok 4, Grok 4 Fast
Ollama Llama 4, Mistral, Qwen, любые локальные
Groq Быстрый inference, бесплатный tier

Простой агент (без инструментов)

Начнём с базового агента, который просто отвечает на вопросы. Это поможет понять структуру:

Структура workflow

Chat Trigger
AI Agent
Respond

Настройка AI Agent

  1. Добавьте ноду Chat Trigger (или Telegram Trigger)
  2. Подключите ноду AI Agent
  3. В AI Agent подключите Chat Model (например, OpenAI Chat Model)
  4. Настройте System Prompt
System Prompt для агента
Ты — умный AI-ассистент компании AIBot.Direct.
Твои задачи:
- Отвечать на вопросы об автоматизации бизнеса
- Помогать с выбором решений
- Консультировать по n8n и ИИ-технологиям

Правила:
- Отвечай кратко и по делу
- Если не знаешь ответа — честно скажи
- При необходимости уточняй вопрос
- Используй русский язык

Подключение Memory

Чтобы агент помнил контекст разговора, добавьте Memory:

  1. В AI Agent нажмите "Add Memory"
  2. Выберите тип памяти:
    • Buffer Memory — хранит все сообщения (потребляет много токенов)
    • Window Memory — последние N сообщений (рекомендуется)
    • Summary Memory — сжимает историю в резюме
  3. Настройте Session ID для разделения пользователей

Session ID

Используйте уникальный идентификатор пользователя как Session ID. Для Telegram: {{ $json.message.chat.id }}. Это позволит каждому пользователю иметь отдельную историю.

RAG-агент с базой знаний

RAG (Retrieval-Augmented Generation) — техника, при которой агент сначала ищет релевантную информацию в базе знаний, а затем использует её для генерации ответа. Это позволяет агенту отвечать на вопросы по вашим документам.

Архитектура RAG в n8n

1

Индексация

Документы → Chunks → Embeddings → Vector Store

2

Поиск

Query → Embedding → Similar Vectors → Relevant Chunks

3

Генерация

Query + Context → LLM → Answer

Шаг 1: Создание базы знаний

Создайте отдельный workflow для индексации документов:

Manual Trigger

Или Schedule для автообновления

Google Drive / HTTP

Загрузка документов (PDF, TXT, MD)

Text Splitter

Разбиение на chunks (500-1000 токенов)

Embeddings

OpenAI / Cohere / Ollama

Vector Store

Pinecone / Qdrant / Supabase

Шаг 2: Настройка агента с RAG

  1. В AI Agent добавьте Vector Store Tool
  2. Подключите тот же Vector Store, что использовали для индексации
  3. Настройте описание инструмента:
Описание Tool для Vector Store
Используй этот инструмент для поиска информации в базе знаний компании.
База содержит: документацию по продуктам, FAQ, инструкции, прайс-листы.
Вызывай инструмент когда пользователь спрашивает о:
- Ценах и тарифах
- Функциях продуктов
- Технических деталях
- Процессах и инструкциях

Выбор Vector Store

Pinecone

Облачный, быстрый, простая настройка. Платный (есть free tier).

Рекомендуется для production

Qdrant

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 для агента продаж

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

Для сложных задач агент сначала составляет план, затем выполняет шаги:

  1. Анализ задачи
  2. Декомпозиция на подзадачи
  3. Последовательное выполнение
  4. Проверка результата
  5. Корректировка при необходимости

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 — выполняйте код в изолированной среде
  • Аудит — логируйте все действия для последующего анализа

Часто задаваемые вопросы

Частые вопросы

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 прямо в нодах. Базовый агент — без единой строки кода.

Понравилась статья? Поставь лайк.

Нужна ИИ-автоматизация под ваш бизнес?

Запишитесь на бесплатную консультацию — обсудим задачу и пришлём готовое решение.

Обсудить проект →

Читайте также

AI / LLM

Claude Opus 4.8: что нового и что даёт бизнесу новая модель ИИ

Читать →

AI / LLM

Локальная LLM на сервере в 2026: модели, железо, стек и бюджеты

Читать →

Право и AI

152-ФЗ и нейросети: отправлять ли данные клиентов в ChatGPT | 2026

Читать →

Полезная статья?

Сохраните в закладки, чтобы не потерять

Ctrl + D