Zep Chat Memory: настройка в AI Flowi Workflow

Zep Chat Memory: настройка хранения переписки на основе Zep в AI Flowi Workflow включает четыре параметра: адрес сервиса, ключ доступа, путь API и сеанс. Компонент возвращает объект Memory, поэтому для получения и отображения текста нужен совместимый обработчик; выход нельзя считать поисковым ответом JSON.

Zep Chat Memory и предлагаемый ниже путь получения и отображения через Message History документированы в каталоге; Ai Flowi не проверяла их в рабочей среде. Экспорт AI Flowi Workflow 1.9.2 от 9 октября 2026 года указывает zep.ZepChatMemory и описывает его как Получает сообщения чата из Zep и сохраняет их. Изучите запись Zep в каталоге вместе с этим справочником настроек.

Четыре настройки Zep Chat Memory

Таблица настроек Zep поддерживает горизонтальную прокрутку, чтобы пояснения к адресу сервиса и сеансу оставались доступными на узких экранах.

В этом снимке все поля отмечены как необязательные. Эти метаданные не подтверждают работоспособность пустой конфигурации и не определяют фактические требования сервиса к аутентификации. Для api_key «Пустой список» означает явные метаданные подключений; у поля пути API список принимаемых подключений вообще отсутствует.

URL сервиса и базовый путь API

Поле url имеет тип str и принимает Message. Поле api_base_path также строковое, с двумя точными экспортированными вариантами: "api/v1" и "api/v2". Эти значения описывают список выбора компонента, а не все версии, которые сервис Zep принимает сейчас.

Правила формирования полного URL из адреса сервиса и пути API для этого компонента Zep не описана. Уточните формат адреса, необходимый вашему фактическому сервису, прежде чем заполнять оба поля; не угадывайте, включает ли URL уже суффикс API. Сам выбор v2 не подтверждает совместимость с целевым сервисом.

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

Идентификатор сеанса и область действия ключа

session_id — строка, принимающая Message, но она выбирает сеанс, а не содержит текущий текст чата. Используйте стабильный идентификатор, назначенный вашим приложением для сеанса с разрешённым доступом. Не подключайте вопрос пользователя к этому полю только потому, что тип принимаемого подключения совпадает.

На этом узле Zep нет отдельно экспортированных user_id, словаря метаданных или поискового запроса. Поэтому выбор сеанса нужно проверять отдельно. Поле сеанса не подтверждает изоляцию пользователей или автоматическое создание ранее неиспользованного идентификатора.

Предоставьте ключ API сервиса, выданный вашему аккаунту Zep, по руководству по работе с ключами доступа и оплачивайте услуги Zep отдельно.

Объект Memory — единственный экспортированный выход

Message History принимает Memory и документирует путь получения и отображения сообщений. Настройку режимов и выходов обработчика смотрите в этом справочнике; специфические вопросы Zep здесь касаются выбора адреса сервиса и сеанса, передаваемого обработчику.

У выхода Zep нет экспортированного порта результатов поиска или документированной схемы записей JSON. Он также не предоставляет именованных операций запросов к графу, удаления или получения списка сеансов. Эти ограничения определяют, какие возможности можно подтверждать для данного компонента конкретного компонента независимо от возможностей, которые поставщик предлагает через другие интерфейсы.

Проверьте один синтетический сеанс с разрешённым доступом

пример настройки, а не зафиксированное испытание

Подготовьте синтетический сеанс с разрешённым доступом и вымышленной заметкой о передаче дел способом, поддерживаемым сервисом. Подготовка сеанса остаётся за пределами этого графа получения данных: интерфейс Zep Chat Memory из четырёх полей не содержит операции создания.

1. Добавьте Zep Chat Memory. Задайте url равным предоставленному для вашего сервиса адресу, а api_key — своему ключу. Универсальный адрес или секретное значение здесь не приводятся.
2. Выбирайте api_base_path равным "api/v1" или "api/v2" только после проверки маршрута, поддерживаемого вашим адресом сервиса. Установите session_id в фактический идентификатор подготовленного синтетического сеанса.
3. Используйте настройку получения и отображения Message History для обработки memory Zep, согласовав идентификатор сеанса обработчика с настройкой Zep.
4. Проверьте приоритет идентификаторов на подключении Memory: и Zep, и Message History предоставляют session_id, но экспорт не содержит правила выбора одного из них при разных значениях.
5. Сравните полученный текст с подготовленной заметкой о передаче дел. Фиксируйте пустой результат, несовпадение сеанса и ошибки сервиса отдельно от завершённого получения текста.

Предполагаемый выход — текст переписки из синтетического сеанса с разрешённым доступом, показанный в Playground. Полученная заметка или успешный запрос не заявляются. Эта проверка запрашивает только текст переписки; настройка и оплата последующего этапа модели описываются в справочнике Language Model.

Для проверки передачи дел зафиксируйте оба настроенных значения session_id, прежде чем изучать полученный текст. Если они различаются, наличие заметки не показывает, какой идентификатор её выбрал: два подготовленных сеанса могут содержать похожий текст. Уточните, по какому правилу обработчик выбирает session_id, прежде чем принимать граф для повторного использования. Изменение настроек отображения Message History не отвечает на этот вопрос выбора на стороне сервера. Сохраняйте заметку вместе с записью о её подготовке, чтобы при отсутствии текста можно было проверить, в каком целевом сеансе он должен находиться, а не объяснять его отсутствие догадками.

Как определить, на каком этапе возник сбой Zep?

Если аутентификация или маршрут API не работают, исследуйте URL, путь и ключ, прежде чем менять порядок получения. Если сервис доступен, но переписка отсутствует, проверьте подготовку сеанса и сопоставление идентификаторов, прежде чем добавлять модель. Модель не может подтвердить создание отсутствующего сеанса.

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

При смене адреса Zep сохраняйте формат URL, предоставленный сервисом, и поддерживаемый путь API вместе в записи конфигурации. Если новый адрес требует другого пути, проверьте эту пару до повторного использования подготовленного идентификатора сеанса; успешный запрос к прежнему адресу ничего не говорит о доступности сеанса по новому. Не перебирайте оба значения до появления текста, чтобы затем считать это контрактом версии. Получите поддерживаемое сочетание URL и пути и проверьте подготовленную заметку по этому адресу. Это отличает перенос на другой адрес от проблемы порядка обработки.

Когда подходит этот интерфейс сеансов

Используйте узел, когда контракт вашего существующего сервиса Zep и сеанса соответствует этим четырём настройкам. Статья о памяти агента в глоссарии объясняет хранение и контекст. Для отдельно названного интерфейса загрузки и поиска с полями пользователя и метаданных изучите интеграцию Mem0; её поисковый выход JSON — другой контракт, а не возможность узла Zep.

Выберите другой проверенный интерфейс, если обязательны прямое получение JSON, операции с графом или удаление. Получите подтверждение совместимости с версией сервиса Zep, прежде чем применять этот снимок к новому адресу сервиса. Каталог интеграций содержит ссылки на существующие категории и области их настройки.

Автор: Ai Flowi · Опубликовано 2026-10-11

Официальный источник: документация Zep

Учёт использования рабочего процесса

Тарифы: Go от USD8 в месяц при годовой оплате (USD10 помесячно), Plus от USD16 (USD20 помесячно), Pro 100 от USD80 (USD100 помесячно), Pro 200 от USD160 (USD200 помесячно) и Pro 500 от USD400 (USD500 помесячно), от 5,000 до 250,000 Flowi Tokens в месяц с возможностью пополнения; 1 токен за каждый запуск узла; использование сторонних API и моделей не включено.