Zep
Долговременная память диалогов Zep в процессах Pailot
Zep — долговременная память для агентов: треды, сообщения, сводки и факты между сессиями.
С Zep в Pailot вы можете:
- Создавать тред, список тредов, удалять тред
- Добавлять и читать сообщения (постранично или последние
lastn)
- Забирать контекст:
summary (связный текст) или basic (сырые факты), с фильтром minRating
- Создавать пользователя, читать карточку и его треды
Нужен ключ API (Application Programming Interface — программный интерфейс) Zep.
Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Ключ — в переменных окружения рабочего пространства.
Новый диалоговый тред.
| Параметр | Тип | Обязательный | Описание |
|---|
threadId | string | Да | Уникальный ID треда |
userId | string | Да | ID пользователя, к которому привязан тред |
apiKey | string | Да | Ключ API Zep |
| Параметр | Тип | Описание |
|---|
threadId | string | ID треда |
userId | string | ID пользователя |
uuid | string | Внутренний UUID |
createdAt | string | Время создания |
projectUuid | string | UUID проекта |
Список тредов.
| Параметр | Тип | Обязательный | Описание |
|---|
pageSize | number | Нет | Тредов на странице |
pageNumber | number | Нет | Номер страницы |
orderBy | string | Нет | Поле сортировки: created_at, updated_at, user_id, thread_id |
asc | boolean | Нет | true — по возрастанию, false — по убыванию |
apiKey | string | Да | Ключ API Zep |
| Параметр | Тип | Описание |
|---|
threads | array | Треды |
responseCount | number | Число тредов в этом ответе |
totalCount | number | Всего тредов |
Удаление треда.
| Параметр | Тип | Обязательный | Описание |
|---|
threadId | string | Да | ID треда |
apiKey | string | Да | Ключ API Zep |
| Параметр | Тип | Описание |
|---|
deleted | boolean | Удалён ли тред |
Контекст треда: сводка или сырые факты.
| Параметр | Тип | Обязательный | Описание |
|---|
threadId | string | Да | ID треда |
mode | string | Нет | Режим: summary (связный текст) или basic (сырые факты) |
minRating | number | Нет | Минимальная оценка релевантных фактов |
apiKey | string | Да | Ключ API Zep |
| Параметр | Тип | Описание |
|---|
context | string | Строка контекста (сводка или факты) |
Сообщения треда.
| Параметр | Тип | Обязательный | Описание |
|---|
threadId | string | Да | ID треда |
limit | number | Нет | Максимум сообщений |
cursor | string | Нет | Курсор постраничного вывода |
lastn | number | Нет | Сколько последних сообщений вернуть (перекрывает limit и cursor) |
apiKey | string | Да | Ключ API Zep |
| Параметр | Тип | Описание |
|---|
messages | array | Сообщения |
rowCount | number | Число сообщений в этом ответе |
totalCount | number | Всего сообщений в треде |
Добавление сообщений в существующий тред.
| Параметр | Тип | Обязательный | Описание |
|---|
threadId | string | Да | ID треда |
messages | json | Да | Массив сообщений с полями role и content |
apiKey | string | Да | Ключ API Zep |
| Параметр | Тип | Описание |
|---|
threadId | string | ID треда |
added | boolean | Удалось ли добавить сообщения |
messageIds | array | UUID добавленных сообщений |
Создание пользователя.
| Параметр | Тип | Обязательный | Описание |
|---|
userId | string | Да | Уникальный ID пользователя |
email | string | Нет | Email |
firstName | string | Нет | Имя |
lastName | string | Нет | Фамилия |
metadata | json | Нет | Дополнительные метаданные (JSON) |
apiKey | string | Да | Ключ API Zep |
| Параметр | Тип | Описание |
|---|
userId | string | ID пользователя |
email | string | Email |
firstName | string | Имя |
lastName | string | Фамилия |
uuid | string | Внутренний UUID |
createdAt | string | Время создания |
metadata | object | Метаданные пользователя |
Карточка пользователя.
| Параметр | Тип | Обязательный | Описание |
|---|
userId | string | Да | ID пользователя |
apiKey | string | Да | Ключ API Zep |
| Параметр | Тип | Описание |
|---|
userId | string | ID пользователя |
email | string | Email |
firstName | string | Имя |
lastName | string | Фамилия |
uuid | string | Внутренний UUID |
createdAt | string | Время создания |
updatedAt | string | Время последнего обновления |
metadata | object | Метаданные пользователя |
Треды конкретного пользователя.
| Параметр | Тип | Обязательный | Описание |
|---|
userId | string | Да | ID пользователя |
limit | number | Нет | Максимум тредов |
apiKey | string | Да | Ключ API Zep |
| Параметр | Тип | Описание |
|---|
threads | array | Треды пользователя |
totalCount | number | Число возвращённых тредов |
