Все ноды/AI/Agent State

Память агента

Долгосрочная структурированная память агента: хранит key-value данные между вызовами. Агент может читать, изменять и удалять значения через встроенные инструменты. Подключается через link_extension.

Память агентаT▶S

ToolsAgent

Set memoryMemory

Тип в графе: agent_memory

ToolExecStateful

Можно включить ветку ошибки (expose_error_output) и обработать сбой отдельным путём.

Как попробовать

Минимальный рабочий воркфлоу

Вход

Память агентаT▶S

Выход▶

Исполнение + данные
Данные

Нажмите «Скопировать ноды», откройте редактор и нажмите Ctrl+V на холсте.

Запускается сразу

Как применять

Память агента — это долгоживущий словарь фактов, который модель ведёт про себя: имя клиента, номер заявки, стадия сценария, предпочтения. Она не хранит реплики: лентой диалога занимаются Буферная, Оконная и Суммаризирующая память. От переменных её отличает, кто пишет: переменную записывает нода графа в момент, который выбрали вы, а сюда пишет модель, когда сочтёт нужным.

Как это работает

Содержимое памяти подставляется в системный промпт блоком <memory> перед каждым запросом — модель видит его всегда, отдельно спрашивать не нужно. Меняет она его инструментами agent_memory_set, agent_memory_delete и agent_memory_clear; набор задаётся полем «Включённые инструменты», а «Открыть инструменты для LLM» выключает запись целиком — память становится справкой только для чтения.

Путь у значения точечный: client.name, order.items.0. Промежуточные словари создаются по дороге, поэтому структуру заранее объявлять не требуется.

«Область» решает срок жизни: thread (по умолчанию) переживает сообщения одного чата, session живёт один запуск, call начинается с нуля каждый ход. Ключ — пара «нода + тред», так что две ноды памяти в графе хранят разные словари. Подробнее — в разделе Переменные и память.

«Запоминать вложения» — отдельный механизм: нода сохраняет ссылки на файлы, которые получил агент (по умолчанию 8 последних), и на следующих ходах снова вкладывает в контекст три самых свежих; остальные перечисляются в промпте по имени. Сами файлы не копируются.

Частые ошибки

Тянуть ребро в порт Memory агента. Выход у ноды — связь расширения, и идёт она в порт Extensions ИИ-агента. Порт Memory принимает только три ноды памяти диалога.
Ждать, что нода отработает шагом графа. Входа Run у неё нет: она живёт спутником агента. Порт Set memory и exec-выход появляются, только когда включено «Задать память из входа», и такое срабатывание заменяет словарь целиком.
Читать память шаблоном nodes.<id>.output. Чтобы отдать словарь в граф, включите «Вывод памяти» и тяните ребро от порта Memory.
Оставлять модели инструмент очистки. agent_memory_clear стирает весь словарь одним вызовом; если это нежелательно, уберите его из «Включённых инструментов».
Складывать в память то, что нужно графу. Условие, фильтр, поле запроса надёжнее держать в переменной: она типизирована, и её значение не зависит от того, вспомнила ли модель про запись.

Входы

Порт	Провод	Данные	Примечания
Tools`tools`	Расширение`link_extension`	—	несколько связей
Set memory`memory_in`	Исполнение + данные`execute_data`	`object`	показывается, когда overwrite_from_input = true

Выходы

Порт	Провод	Данные	Примечания
Agent`output`	Расширение`link_extension`	—
Memory`memory_out`	Данные`data`	`object`	показывается, когда expose_memory_output = true

Настройки

Поле	Тип	По умолчанию	Описание
Включённые инструменты`enabled_tools`	`array<string>`	`["set","delete","clear"]`	Какие инструменты памяти доступны LLM
Вывод памяти`expose_memory_output`	`boolean`	`false`	Показать data-порт вывода, который отдаёт текущий словарь памяти.
Открыть инструменты для LLM`expose_tools`	`boolean`	`true`	Разрешить LLM вызывать инструменты памяти (set, delete, clear)
Форматировать инструменты памяти в Catch Tool Call`format_in_catch`	`boolean`	`true`	Использовать короткие читаемые строки для вызовов инструментов памяти в потоке Extra
Начальное состояние памяти`initial_memory`	`object`	`{}`	Начальное состояние памяти агента (пары ключ-значение)
Макс. повторно встраиваемых вложений`max_reinlined_attachments`	`integer`	`3`	Сколько самых свежих запомненных вложений повторно встраивать в контекст при каждом запуске. Файлы сверх этого числа только перечисляются по имени.
Макс. запоминаемых вложений`max_remembered_attachments`	`integer`	`8`	Сколько ссылок на вложения хранить (сохраняются самые новые).
Задать память из входа`overwrite_from_input`	`boolean`	`false`	Показать входной порт памяти (ED), срабатывание которого полностью заменяет сохранённую память, плюс exec-выход «History set», срабатывающий после записи.
Запоминать вложения`remember_attachments`	`boolean`	`false`	Сохранять ссылки на вложения, которые получает агент, и повторно встраивать самые свежие из них в контекст модели в последующих ходах/сессиях.
Область`scope`	`string`	`thread`	thread: сохраняется между сообщениями чата · session: живёт одно выполнение · call: заново каждый раз Варианты: `thread` — Тред, `call` — Вызов, `session` — Сессия

Общие поля

Эти три поля есть у каждой ноды: платформа добавляет их сама, а не автор ноды.

expose_error_output — Если включено, показывает выход выполнения для подключения нод, которые запускаются при сбое этого шага.