ММООЗЗГГ.ru

Как создать ИИ-агента

Память агента: история диалога, факты о клиенте, правила

Михаил Мозг4 минуты чтения

Память ИИ-агента бывает трех видов: история текущего диалога, факты о клиенте между диалогами и общие правила работы. Если в памяти есть данные клиентов, действует 152-ФЗ: их хранят в базах на территории России, а при отзыве согласия уничтожают не позже чем через 30 дней.

Нужен разработчик

Три вида памяти

Модель не помнит ничего между запросами. Все, что агент «помнит», программа хранит отдельно и подкладывает модели в контекст, то есть в текст, который модель видит при ответе.

Короткая память: история текущего диалога. Агент помнит, что клиент написал три сообщения назад, и не переспрашивает. В документации LangChain это память в пределах одной беседы.

Долгая память: факты о клиенте между диалогами. Имя, прошлые заказы, предпочтения, договоренности. Ее хранят в базе с привязкой к клиенту и достают, когда он пишет снова.

Общая память: правила и опыт, одинаковые для всех клиентов. LangChain делит долгую память на факты, опыт прошлых действий агента и инструкции, а инструкции агента это его системный промпт.

Память одна из 7 деталей агента, рядом с моделью, инструкцией, инструментами и знаниями. Как детали собираются вместе, показано в схеме устройства агента.

Как устроить

В n8n короткую память подключают к узлу «AI Agent» отдельным узлом. «Simple Memory» хранит историю внутри n8n, а параметр «Context Window Length» задает, сколько прошлых сообщений агент учитывает.

У «Simple Memory» есть ограничение из документации n8n: в режиме очереди, когда n8n работает на нескольких обработчиках, узел не подходит для рабочего процесса.

Для рабочего процесса историю хранят в своей базе, например в PostgreSQL на сервере в России. Порядок в n8n:

1. Подключите к узлу «AI Agent» узел «Postgres Chat Memory» и выберите учетные данные вашей базы PostgreSQL.

2. В поле «Table Name» укажите таблицу для истории. Если таблицы нет, n8n создаст ее сам.

3. В поле «Session Key» укажите ключ беседы, например номер чата клиента, чтобы истории разных клиентов не смешивались.

4. В поле «Context Window Length» задайте, сколько прошлых сообщений агент учитывает в ответе.

Длинную историю целиком не передают. LangChain предупреждает: полная история может не поместиться в контекст модели, а на длинном контексте модели отвечают хуже, медленнее и дороже. Поэтому устаревшие сообщения убирают из контекста.

Долгую память держат в базе с карточкой клиента или прямо в CRM. Агент читает ее инструментом «найти клиента» и записывает новое инструментом «обновить карточку». Так память видна сотрудникам, а не спрятана в программе агента.

Anthropic устроила свой инструмент памяти так же: модель только просит прочитать или записать файл, а хранит данные ваша программа в вашем хранилище. Для 152-ФЗ это удобно: место хранения выбираете вы.

Claude Agent SDK описывает цикл агента как «собрать контекст, сделать действие, проверить результат, повторить». Память входит в контекст, который агент собирает перед действием.

Персональные данные в памяти

Имя, телефон, адрес и история заказов клиента это персональные данные. Оператор данных ваша компания, и 152-ФЗ требует собирать и хранить данные граждан России в базах на территории России.

Если память или модель находятся за рубежом, до передачи данных оператор подает уведомление в Роскомнадзор. Это правило действует с 1 марта 2023 года.

Правило для памяти: храните только то, что нужно процессу. Агенту записи нужны имя, телефон и время визита, паспорт и вся история покупок ему не нужны.

Срок хранения задают заранее. Когда цель обработки достигнута, например заказ выполнен и гарантийный срок прошел, по части 4 статьи 21 обработку прекращают, а данные уничтожают не позже чем через 30 дней.

Не записывайте в долгую память то, что клиент сообщил между делом: сведения о здоровье, семье, данные других людей. Для работы агента они не нужны, а при утечке ущерб от них выше.

Как мы храним данные клиентов в своих проектах, описано на странице о безопасности данных. Права агента и журнал действий собраны в чек-листе защиты агента.

Удаление по запросу

Клиент вправе узнать, что о нем хранится, и отозвать согласие. По статье 20 закона 152-ФЗ на запрос сведений оператор отвечает в течение 10 рабочих дней, а продлить срок можно еще на 5 рабочих дней с объяснением причины.

Если клиент показал, что данные неточные или собраны без основания, оператор исправляет или уничтожает их не позже чем через 7 рабочих дней.

При отзыве согласия по части 5 статьи 21 обработку прекращают, а данные уничтожают не позже чем через 30 дней, если договор или закон не разрешают хранить их дальше.

Для агента отсюда одно требование: память удаляется по клиенту, а не только целиком. Историю диалогов и долгую память хранят с ключом клиента, чтобы найти и стереть все его записи одной операцией.

Проверьте копии. Журнал действий, выгрузки для проверки качества и резервные копии тоже содержат переписку, и удаление проходит по всем местам, где лежат данные.

Это не юридическая консультация: порядок удаления и тексты согласий проверяет юрист.

Источники и даты

Собрать просто. Решить, что собирать, сложнее

Подключить память к агенту технически несложно. Сложнее решить, что агенту помнить о клиенте, чтобы это приносило продажи, и чего не хранить по 152-ФЗ. Это решают с владельцем процесса и юристом до сборки.

Разбор 30 минут

На разборе посмотрим, что ваш агент хранит о клиентах и как удалить данные клиента по его запросу.

Михаил Мозг

Михаил Мозг

Основатель MMOOZZGG, ИИ-директор

Подробнее о Михаиле@mmoozzggru

Контакты

Проверим, что агент помнит о ваших клиентах

Разбор 30 минут бесплатно в Telegram: пройдем по памяти агента и требованиям 152-ФЗ.

Написать в Telegram