GPT-ассистент на n8n: AI Agent, инструменты и память ¶
Обновлено: 2026-05-29
GPT-ассистент в n8n — это workflow, где пользователь отправляет запрос, AI Agent анализирует задачу и при необходимости вызывает инструменты: поиск в базе, HTTP Request, Notion, Google Sheets, Telegram или другой workflow.
Минимальная архитектура¶
- Trigger: Telegram, Webhook, Chat Trigger или форма.
- Set / Edit Fields: очистка текста, user_id, контекст.
- AI Agent: системная инструкция и подключённая модель.
- Tools: HTTP Request, PostgreSQL, Notion, другие workflow.
- Response: Telegram node, Respond to Webhook или Email.
Когда нужен AI Agent¶
| Задача | OpenAI node | AI Agent |
|---|---|---|
| Суммаризировать текст | Да | Не обязательно |
| Классифицировать заявку | Да | Не обязательно |
| Выбрать инструмент | Нет | Да |
| Сходить в CRM и ответить | Сложно | Да |
Системная инструкция¶
Ты помощник компании. Отвечай кратко и по делу.
Если для ответа нужны данные клиента, используй доступные инструменты.
Никогда не удаляй и не изменяй данные без явного подтверждения пользователя.
Если данных не хватает, задай один уточняющий вопрос.Безопасность инструментов¶
AI Agent не должен иметь неограниченный доступ к опасным действиям. Разделяйте инструменты на безопасные read-only и действия с изменением данных. Для действий «создать заказ», «удалить запись», «отправить сообщение всем» добавляйте human approval или отдельную IF-проверку.
Память и контекст¶
Для MVP достаточно передавать последние сообщения из базы по user_id. Для более сложной памяти можно хранить краткие summaries, профили пользователей и важные факты отдельно. Не отправляйте модели всю историю без ограничения — это дороже и менее стабильно.
Логирование¶
- Сохраняйте user_id, prompt category, tools used, status и error message.
- Не храните полный sensitive input без необходимости.
- Отдельно логируйте tool calls: какой инструмент вызван и с каким результатом.
Архитектура production workflow ¶
Для сценария GPT-ассистент на n8n: AI Agent, инструменты и память полезно строить workflow не как одну длинную цепочку, а как понятный конвейер: вход, нормализация, проверка, основное действие, запись результата и обработка ошибок. Тогда статью можно использовать как инструкцию внедрения, а не как набор разрозненных советов.
| Слой | Задача | Что логировать |
|---|---|---|
| Trigger | получить событие от внешний сервис, данные и execution history | event_id, source, время получения |
| Normalize | привести поля к единой схеме | id события или записи, source, created_at, status, payload_hash |
| Validate | отсечь пустые, повторные и рискованные входы | причину отказа и исходный payload_hash |
| Action | выполнить главное действие рецепта | id созданной/обновлённой записи |
| Notify | сообщить человеку или системе результат | канал, статус, ссылка на execution |
Минимальная схема данных ¶
Не начинайте рецепт с настройки красивых уведомлений. Сначала определите контракт данных: какие поля приходят, какие обязательны, где создаётся уникальный ключ и что считается успешным результатом. Для этой статьи базовый контракт можно начать с таких полей:
- id события или записи
- source
- created_at
- status
- payload_hash
Если поля отличаются у разных источников, добавьте отдельную нормализационную ноду сразу после trigger. Это снижает количество выражений в последующих нодах и упрощает поддержку.
Проверка на реальных крайних случаях ¶
- пустой payload или форма без обязательного поля
- повторная доставка одного и того же события
- частичный успех: внешняя запись создана, но уведомление не отправилось
- медленный API или временный 429/5xx
- ручной повтор старого execution через неделю после первого запуска
MVP и production-версия рецепта
Рецепт GPT-ассистент на n8n: AI Agent, инструменты и память не должен конкурировать со справочником нод. Здесь важен готовый сценарий: какие ноды соединить, какие данные передать и как проверить бизнес-результат.
| Уровень | Что включить | Что пока не делать |
|---|---|---|
| MVP | Webhook/Trigger, нормализация, основное действие, короткий ответ | сложные retry, multi-tenant логику, лишние ветки |
| Production | idempotency, error workflow, лог статусов, ручная очередь, alert | хранить токены в тексте нод или логировать полный payload |
| Scale | очередь, лимиты, batch processing, SLA-метрики | раздувать один workflow до нечитабельной схемы |
Как понять, что рецепт готов
- Есть один владелец процесса и понятный критерий успеха: лид создан, письмо отправлено, документ сохранён, задача закрыта.
- Повторный запуск с тем же payload не создаёт дубль.
- Ошибочный payload не теряется, а попадает в manual review или alert.
- Все внешние API вызываются через credentials, а не через токен в plain text.
- К рецепту привязан готовый шаблон в разделе workflow или указано, почему шаблон не нужен.
Что читать дальше¶
По нодам: AI Agent, OpenAI, Set / Edit Fields. Для интерфейса — Telegram-бот.