Память (Memory)
Запись и чтение кратковременной памяти процесса между шагами
Память — встроенное хранилище процесса: записать сообщение и прочитать его на следующих шагах. Записи группируются по conversationId (идентификатор диалога). Если запись с таким ID уже есть, новое сообщение дописывается к ней.
С памятью в Pailot вы можете:
- Добавлять сообщение с ролью user, assistant или system
- Читать историю по
conversationId
- Получить все записи или удалить их по диалогу
Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Внешний ключ не нужен.
Добавить запись или дописать сообщение к существующей памяти с тем же ID.
| Параметр | Тип | Обязательный | Описание |
|---|
conversationId | string | Нет | Идентификатор диалога (например user-123, session-abc). Если память с таким ID уже есть, сообщение дописывается |
id | string | Нет | Устаревший идентификатор диалога. Используйте conversationId. Оставлен для совместимости |
role | string | Да | Роль: user, assistant или system |
content | string | Да | Текст записи |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли сохранить память |
memories | array | Записи, включая новую или обновлённую |
error | string | Текст ошибки, если операция не удалась |
Прочитать память по conversationId.
| Параметр | Тип | Обязательный | Описание |
|---|
conversationId | string | Нет | Идентификатор диалога. Вернёт записи этого диалога |
id | string | Нет | Устаревший идентификатор диалога. Используйте conversationId. Оставлен для совместимости |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли прочитать память |
memories | array | Записи с полями conversationId и data |
message | string | Сообщение об успехе или ошибке |
error | string | Текст ошибки, если операция не удалась |
Все записи памяти.
| Параметр | Тип | Обязательный | Описание |
|---|
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли получить все записи |
memories | array | Все записи: key, conversationId и data |
message | string | Сообщение об успехе или ошибке |
error | string | Текст ошибки, если операция не удалась |
Удалить память по conversationId.
| Параметр | Тип | Обязательный | Описание |
|---|
conversationId | string | Нет | Идентификатор диалога. Удаляет все записи этого диалога |
id | string | Нет | Устаревший идентификатор диалога. Используйте conversationId. Оставлен для совместимости |
| Параметр | Тип | Описание |
|---|
success | boolean | Удалось ли удалить память |
message | string | Сообщение об успехе или ошибке |
error | string | Текст ошибки, если операция не удалась |
