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