# Найкращі практики роботи з пам'яттю SUMMARY: Як структурувати спогади для ефективного відкликання — категорії, ключі, теги, пріоритети. Найкращі практики роботи з пам'яттю Те, як ви структуруєте спогади, визначає їхню корисність. Цей посібник охоплює шаблони категоризації, тегування та пріоритизації спогадів, щоб LLM міг відкликати правильну інформацію в потрібний момент. Категорії: обирайте найбільш конкретну | Категорія | Для чого | Приклад | |----------|---------|---------| | | Ім'я, роль, контактна інформація | | | | Подобання, антипатії, стиль роботи | | | | Перевірювані факти | | | | Статус проєкту, рішення | | | | Навички користувача | | | | Минулі помилки для уникнення | | | | Контекст, релевантний сесії | | | | Різні нотатки | | > [!TIP] > У разі сумніву використовуйте для перевірюваної інформації та > для всього іншого. Не надмірно категоризуйте — краще мати чіткий , ніж > заплутаний . Ключі: змістовні ідентифікатори Поле — це ідентифікатор спогаду. Використовуйте змістовні, стабільні ключі: Хороші ключі: - - - - Погані ключі: - (не змістовний) - (не описовий) - (дата не допомагає відкликанню) Угоди іменування ключів - (нижній регістр із підкресленнями) - Префіксуйте категорією: , , - Використовуйте описові іменники, а не дієслова - До 50 символів Теги: для пошуку та фільтрації Теги забезпечують швидку фільтрацію та пошук. Додавайте 2-5 тегів на спогад: [CODE BLOCK] Шаблони тегів - Назви проєктів: , , - Тем: , , , - Статусу: , , - Індикатори пріоритету: , > [!NOTE] > Теги нечутливі до регістру. Використовуйте нижній регістр для узгодженості. Пріоритети: будьте реалістичними | Пріоритет | Для чого | % спогадів | |----------|---------|---------------| | | Ідентичність користувача, юридична інформація, незворотні рішення | 5% | | | Активні проєкти, важливі уподобання | 20% | | | Більшість фактів, нотаток, контексту | 65% | | | Ефемерне, корисно знати | 10% | > [!WARNING] > Не позначайте все . Якщо все критичне, то нічого не критичне. > Залишайте для речей, що спричинять реальну шкоду при забуванні. Коли зберігати, а коли ні Завжди зберігайте - Ідентичність користувача (ім'я, email, роль) - Довготривалі уподобання - Рішення про проєкт та їх обґрунтування - Минулі помилки та отримані уроки - Зобов'язання перед користувачем Не зберігайте - Перехідний стан (використовуйте змінні) - Історію розмов дослівно (це обробляє система чату) - Чутливі дані (паролі, API-ключі) - Факти, що легко вивести (поточна дата, вміст файлів) - Ефемерний контекст (використовуйте категорію із низьким пріоритетом) Оновлення спогадів POST з тією ж + оновлює наявний спогад: [CODE BLOCK] > [!TIP] > Використовуйте стабільні ключі, щоб оновлювати без створення дублікатів. LLM > має повторно POST-нути той самий ключ при зміні інформації, а не створювати > нові спогади. Життєвий цикл спогаду [CODE BLOCK] - Create: POST /memory з повним контекстом - Active: Часто відкликати, оновлювати за потреби - Stale: Ще релевантні, але не активно використовуються (знизити пріоритет?) - Archive: Встановити пріоритет , зберігати для історичного довідника - Delete: DELETE /memory/:id, коли більше не релевантний Періодичне очищення [CODE BLOCK] Шаблон: успадкування спогадів Для ієрархічного контексту (проєкт → підпроєкт → завдання): [CODE BLOCK] Потім LLM може шукати , щоб знайти всі пов'язані спогади. Шаблон: журнал рішень Зберігайте рішення з обґрунтуванням, щоб LLM не переробляв їх: [CODE BLOCK] Шаблон: уникнення помилок Зберігайте помилки зі специфічними інструкціями уникнення: [CODE BLOCK] Антишаблони для уникнення > [!WARNING] > - Зберігання логів розмов — це обробляє система чату > - Зберігання цілих файлів — використовуйте сховище скриптів або зовнішнє сховище > - Зберігання ефемерного стану — використовуйте змінні > - Зберігання секретів — використовуйте змінні середовища > - Дублювання спогадів — використовуйте стабільні ключі > - Надмірне тегування — 2-5 тегів на спогад ідеально > - Усе критичне — будьте реалістичними з пріоритетами Наступні кроки - Memory API - Постійний LLM-агент - Стратегія тегування пам'яті