Как настроить память агента в n8n: добавьте к ноде AI Agent отдельную ноду памяти и подключите её к агенту. В документации n8n сказано, что память хранит историю предыдущих сообщений и обеспечивает продолжение разговора, когда каждое взаимодействие не начинается заново. Простейший вариант — Simple Memory, хранящая настраиваемую длину истории чата для текущей сессии; это самый простой старт. Для постоянного хранения между запусками подключают сервисные ноды памяти.
Прямой ответ и границы продукта
Память агента в n8n — это отдельный компонент, который подключается к ноде AI Agent и передаёт модели историю сообщений. В документации проекта память описана как ключевая часть чат-сервисов: она хранит историю предыдущих сообщений и позволяет вести продолжающийся разговор. Без подключённой памяти агент обрабатывает каждый запрос как новый.
Границы продукта определяются набором нод. Документация n8n перечисляет два пути добавления памяти: Simple Memory для текущей сессии и сервисные ноды памяти, среди которых Motorhead, Redis Chat Memory, Postgres Chat Memory, Xata и Zep. Simple Memory хранит настраиваемую длину истории чата для текущей сессии и считается самым простым вариантом для старта. Сервисные ноды подключаются к внешнему хранилищу и удерживают историю между запусками.
Отдельная нода Chat Memory Manager закрывает задачи, выходящие за рамки обычных нод памяти. В документации проекта указано, что она управляет памятью сообщений чата внутри workflow: загружает, вставляет и удаляет сообщения чата во внутреннем векторном хранилище. Её применяют, когда нужно проверить размер памяти в ответе ноды Agent и уменьшить его при необходимости, а также когда требуется внедрить в диалог сообщения, выглядящие как пользовательские, чтобы дать модели больше контекста.
Память агента и память инстанса n8n — разные вещи. Первая отвечает за историю диалога, вторая относится к ресурсам сервера. Документация по развёртыванию описывает ошибки нехватки памяти при самостоятельном хостинге и отдельно отсылает к разделу об управлении данными в n8n Cloud для лимитов облачных планов.
Условия доступа и источник актуальных требований
Актуальные требования живут в документации n8n. Раздел о работе памяти описывает типы нод и их назначение, страница о Chat Memory Manager перечисляет режимы работы, страница о Postgres Chat Memory фиксирует параметры подключения. Эти страницы обновляются вместе с продуктом, поэтому сверять настройки стоит по ним.
Для облачных инсталляций действуют лимиты памяти по планам. Документация n8n Cloud приводит такие значения:
| План n8n Cloud | Память | CPU |
|---|---|---|
| Trial | 640MiB RAM | 10 millicore CPU burstable |
| Starter | 640MiB RAM | 10 millicore CPU burstable |
| Pro-1 (10k executions) | 640MiB RAM | 20 millicore CPU burstable |
| Pro-2 (50k executions) | 1280MiB RAM | 80 millicore CPU burstable |
| Enterprise | 4096MiB RAM | 80 millicore CPU burstable |
В документации отмечено, что сам n8n потребляет память для работы: в среднем программное обеспечение использует около 180MiB RAM. Взаимодействие с интерфейсом тоже расходует память, и активная работа с UI во время тяжёлых выполнений способна вывести инстанс за лимит. Каждому инстансу n8n даёт до 100GB хранилища данных.
Для самостоятельного хостинга ограничения задаёт ваша инфраструктура. Документация по устранению проблем с памятью описывает ошибки, возникающие при нехватке ресурсов, и предлагает два направления: увеличить доступную память или снизить её потребление. При самостоятельном хостинге увеличение памяти означает выделение инстансу большего объёма, что может повлечь дополнительные расходы у хостинг-провайдера. В n8n Cloud для этого нужно перейти на более крупный план.
Порядок действий по настройке памяти
Порядок опирается на структуру нод, описанную в документации n8n. Работа идёт в редакторе workflow.
- Добавьте ноду AI Agent и настройте её: цель, модель, инструменты.
- Добавьте ноду памяти. Для быстрого старта подойдёт Simple Memory, хранящая настраиваемую длину истории чата для текущей сессии.
- Подключите ноду памяти к агенту через соответствующее гнездо.
- Задайте длину истории для Simple Memory. Этот параметр определяет, сколько предыдущих сообщений попадёт в контекст.
- Для постоянного хранения выберите сервисную ноду: Postgres Chat Memory, Redis Chat Memory, Motorhead, Xata или Zep.
- В сервисной ноде заполните Session Key — ключ, по которому память хранится в данных workflow.
- Для Postgres Chat Memory укажите Table Name: система создаст таблицу, если её нет.
- Задайте Context Window Length — число предыдущих взаимодействий, учитываемых для контекста.
- Проверьте поведение агента на нескольких последовательных сообщениях.
Нода Postgres Chat Memory использует Postgres как сервер памяти для хранения истории чата. Аутентификация описана в документации по учётным данным Postgres. Параметры Session Key, Table Name и Context Window Length перечислены на странице ноды.
Важная деталь про несколько нод памяти. В документации по Postgres Chat Memory указано: если добавить в workflow больше одной такой ноды, все они по умолчанию обращаются к одному экземпляру памяти. Деструктивные операции, перезаписывающие содержимое памяти, требуют осторожности — пример такой операции, Override All Messages, есть в ноде Chat Memory Manager. Для нескольких независимых экземпляров памяти задайте разные session ID в разных нодах.
Учебный пример и критерии проверки
Соберём упражнение на разговорном сценарии. Агент принимает сообщения пользователя и должен помнить, что было сказано ранее в той же сессии.
Схема: триггер чата → нода AI Agent с подключённой Simple Memory → ответ пользователю. Длина истории задаётся так, чтобы в контекст попадали последние реплики.
Проверка строится на последовательных сообщениях. Отправьте агенту имя, затем отдельным сообщением попросите его назвать это имя. При работающей памяти агент назовёт его, при отключённой — обработает запрос как новый.
Критерии самостоятельной проверки:
- Агент воспроизводит сведения из предыдущего сообщения в той же сессии.
- При перезапуске сессии с Simple Memory история не сохраняется.
- С сервисной нодой памяти история переживает перезапуск.
- Разные Session Key дают независимые истории.
- Уменьшение Context Window Length сокращает объём передаваемого контекста.
Для постоянного хранения замените Simple Memory на Postgres Chat Memory и повторите тест с перезапуском. История должна сохраниться в таблице, имя которой вы задали.
Смежные варианты и выбор по задаче
Выбор ноды памяти определяется сроком жизни истории и инфраструктурой.
| Вариант | Хранение | Когда подходит |
|---|---|---|
| Simple Memory | Текущая сессия | Быстрый старт, прототип |
| Postgres Chat Memory | Внешняя база Postgres | Постоянная история на своём сервере |
| Redis Chat Memory | Внешнее хранилище Redis | Быстрый доступ к истории |
| Motorhead | Внешний сервис | Отдельный сервис памяти |
| Xata | Внешний сервис | Хранение в облачном сервисе |
| Zep | Внешний сервис | Отдельный сервис памяти |
| Chat Memory Manager | Внутреннее векторное хранилище | Ручное управление сообщениями |
Chat Memory Manager поддерживает три режима операций: Get Many Messages, Insert Messages и Delete Messages. В режиме Insert Messages доступны два варианта: Insert Messages добавляет сообщения рядом с существующими, Override All Messages заменяет текущую память. В режиме Delete Messages доступны Last N для удаления последних N сообщений и All Messages для очистки памяти целиком.
При вставке сообщений задаётся тип: AI для сообщений от модели, System для инструкций модели, User для сообщений пользователя. Поле Message содержит текст, а Hide Message in Chat определяет, показывать ли сообщение в интерфейсе чата. В режиме Get Many Messages доступна опция Simplify Output, сокращающая вывод до отправителя и текста.
Типичные проблемы и диагностика
Проблемы делятся на два класса: поведение агента и ресурсы инстанса.
Агент забывает контекст. Проверьте, подключена ли нода памяти к агенту и задан ли Session Key. При нескольких нодах памяти с одинаковым session ID истории смешиваются; в документации по Postgres Chat Memory для этого случая рекомендованы разные session ID.
Агент не сохраняет историю между запусками. Simple Memory хранит историю текущей сессии, поэтому перезапуск её очищает. Для постоянного хранения нужна сервисная нода.
Нехватка памяти инстанса проявляется конкретными сообщениями. Документация n8n приводит такие признаки: сообщение вида Execution stopped at this node (n8n may have run out of memory while executing it), а также Problem running workflow, Connection Lost и 503 Service Temporarily Unavailable, указывающие на недоступность инстанса. При самостоятельном хостинге в логах сервера появляется Allocation failed — JavaScript heap out of memory.
На n8n Cloud и в Docker-образе n8n перезапускается автоматически при такой ситуации. При запуске через npm перезапуск может потребоваться вручную.
Снижение потребления памяти. Документация предлагает разбивать обрабатываемые данные на меньшие порции: вместо выборки 10 000 строк за выполнение обрабатывать 200 строк за раз. Ноды Code и старая Function заметно увеличивают потребление, поэтому их советуют избегать. Ручные выполнения расходуют больше памяти, так как n8n делает копию данных для интерфейса; при больших объёмах их советуют не использовать. Разделение workflow на подпроцессы снижает потребление: подпроцесс держит в памяти данные текущей порции и освобождает её после возврата ограниченного результата родительскому workflow. Для этого добавляют ноду Loop Over Items и ноду Execute Workflow.
Для ошибок JavaScript heap out of memory при самостоятельном хостинге документация предлагает выделить дополнительную память старой секции движка V8 через опцию —max-old-space-size=SIZE в CLI или переменной окружения NODE_OPTIONS.
Частые вопросы
Что такое память агента в n8n?
Это компонент, подключаемый к ноде AI Agent и передающий модели историю предыдущих сообщений. В документации n8n память описана как ключевая часть чат-сервисов: она хранит историю и обеспечивает продолжение разговора. Без неё каждое взаимодействие начинается заново.
Какие типы памяти есть в n8n?
Документация перечисляет Simple Memory для текущей сессии и сервисные ноды: Motorhead, Redis Chat Memory, Postgres Chat Memory, Xata и Zep. Отдельно существует нода Chat Memory Manager для ручного управления сообщениями. Simple Memory считается самым простым вариантом для старта.
Почему агент забывает контекст?
Причины связаны с подключением и настройкой памяти. Проверьте, подключена ли нода памяти к агенту и задан ли Session Key. При нескольких нодах памяти с одинаковым session ID истории смешиваются. Simple Memory хранит историю только текущей сессии.
Как хранить историю между запусками?
Подключите сервисную ноду памяти, например Postgres Chat Memory. Она использует Postgres как сервер памяти для хранения истории чата. Задайте Session Key и Table Name: система создаст таблицу, если её нет. История переживёт перезапуск.
Что делать при ошибке нехватки памяти?
Документация предлагает два направления: увеличить доступную память или снизить потребление. Для снижения разбивайте данные на меньшие порции, избегайте нод Code и Function, отказывайтесь от ручных выполнений при больших объёмах, делите workflow на подпроцессы. При самостоятельном хостинге помогает опция —max-old-space-size.
Если вы настраиваете сетевой доступ для инстанса, пригодится материал Как настроить прокси для n8n. Ошибки интеграции с моделями разобраны в статье LangChain не работает: причины и решения. Про ограничения другого инструмента — Cursor: лимиты и ограничения запросов.