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

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

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

Что такое 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-агент — это система на базе LLM (GPT-4, Claude), которая может не только отвечать на вопросы, но и выполнять действия: искать информацию, обращаться к API, создавать записи в CRM, отправлять сообщения. n8n позволяет "давать" агенту инструменты (tools) для взаимодействия с внешним миром.

Обычный чат-бот только генерирует текст на основе промпта. AI-агент умеет: 1) Планировать действия, 2) Использовать инструменты (поиск, API, БД), 3) Рассуждать и принимать решения, 4) Выполнять многошаговые задачи автономно.

Для агентов нужны модели с хорошим function calling: GPT-5.1, Claude Opus 4.5, Gemini 3 Pro, Grok 4. Локальные модели (Llama 4, Mistral) подходят для простых задач, но хуже справляются со сложным планированием.

Ключевые меры: 1) Ограничьте набор доступных инструментов, 2) Валидируйте входные данные, 3) Логируйте все действия агента, 4) Установите лимиты на количество действий, 5) Добавьте подтверждение для критических операций.

Да, n8n позволяет создать базового агента визуально, без кода. Однако для продвинутых сценариев (кастомные инструменты, сложная логика) понадобится JavaScript в Code-нодах. n8n значительно упрощает разработку по сравнению с чистым кодом.

Нужен AI-агент для вашего бизнеса?

Мы создаём умных AI-агентов на n8n: от простых RAG-ботов до сложных многоагентных систем. Интеграция с вашей CRM, базами данных, мессенджерами. Полная приватность данных.

0 просмотров