База знань для ШІ-агента: як дати йому памʼять
Щоб агент не приходив щоранку з амнезією
Як зібрати ШІ-агенту робочу базу знань: де зберігати факти, рішення та нотатки, щоб він памʼятав їх після перезапуску й не перетворював памʼять на смітник.
Що таке база знань агента простими словами
Уяви геніального стажера. Розумний, швидкий, схоплює на льоту. Один нюанс: щоранку він приходить із повною амнезією. Не памʼятає, як тебе звати. Не памʼятає, що ви робили вчора, який шрифт обрали й чому вирішили НЕ чіпати ту страшну папку.
Що робить нормальний начальник? Точно не переказує все наново щоранку - так і до вигорання недалеко. Він заводить стажеру зошит із головними фактами: «клієнта звати так-то», «шрифт - Fraunces», «папку legacy не чіпаємо, там усе тримається на чесному слові». Стажер прийшов, відкрив зошит - і знову в темі.
Ось цей зошит і є база знань. А knowledge-ops knowledge-ops (knowledge operations) - управління базою знань: як складати факти, рішення та нотатки у файли так, щоб їх потім легко було знайти, оновити й не загубити. По суті - наведення ладу в памʼяті агента. - мистецтво вести її так, щоб вона допомагала, а не перетворювалася на комірчину зі старими коробками.
Навіщо вайбкодеру памʼять агента
Ти вайбкодер. Руками код не пишеш - але задачу агенту пояснюєш постійно. І якщо в агента немає бази знань, ти пояснюєш одне й те саме по колу. Щоразу з нуля. Це дорого (платиш токенами за кожен переказ), довго й просто бісить.
З нормальною базою знань усе інакше. Ти:
- перестаєш повторювати одні й ті самі вступні дані по сто разів;
- отримуєш стабільний результат - агент спирається на ті самі факти, а не вигадує нові на ходу;
- повертаєшся до проєкту за місяць і не ламаєш голову над питанням «а що ми там вирішили»;
- знаходиш потрібне за секунду замість того, щоб перечитувати все листування.
Різниця між «агент знову гальмує, як першого дня» і «агент одразу в темі» - це майже завжди різниця в тому, чи є в нього зошит. І в якому він стані.
З чого складається база знань: полички та їхні ролі
База знань - це не один файл-смітник. Це кілька поличок, і в кожної своя роль. Тримати всі шість одразу не треба - почни з двох-трьох. Але розуміти, що куди кладеться, корисно.
1. Поличка швидких нотаток: коротка памʼять проєкту
Найпотрібніше й найчастіше вживане: уподобання, контекст проєкту, головні факти. Це markdown-файли, які агент підхоплює на початку кожної сесії. Вважай їх стікерами на видному місці.
Сюди: «клієнта звати так-то», «пишемо українською», «дедлайн такий-то».
2. Поличка рішень: чому ми зробили саме так
Окремо варто зберігати ухвалені рішення разом із причинами. Не просто «шрифт Fraunces», а «шрифт Fraunces, бо замовник хотів дорого й вінтажно». За місяць саме це «чому» рятує від переробок по колу.
3. Поличка довгих документів
Великі тексти: дослідження, довгі інструкції, витяги з розмов. Їх не тримають серед швидких нотаток - забʼють увесь стіл. Складають окремо й дістають цілком, коли потрібно.
4. Поличка пошуку за змістом
Шар серйозніший: граф знань Граф знань - спосіб зберігати факти як повʼязані між собою шматочки: «Аня - менеджер проєкту X», «проєкт X використовує базу Y». Можна шукати не за точними словами, а за змістом і звʼязками. через спеціальний інструмент памʼяті. Він шукає за змістом, а не за точним збігом слів, і бачить звʼязки між фактами. На старті, чесно кажучи, без нього чудово живеться.
Робочий цикл knowledge-ops: як класти знання правильно
У скілі knowledge-ops це чотири кроки. Запамʼятай ланцюжок: «класифікуй → перевір дублі → запиши → онови індекс».
1. Класифікуй факт
Запитай себе: що це за факт і куди він належить за змістом? Особисте вподобання - на поличку нотаток. Ухвалене рішення - на поличку рішень. Величезний документ - окремо, а в нотатках залиш короткий витяг і посилання.
2. Перевір на дублі - це найважливіше
Спершу шукай, потім пиши. Перш ніж додати факт - глянь, чи немає його вже. Є? Онови старий запис, а не плоди другий. Інакше за тиждень у тебе три нотатки про один шрифт, і всі трохи різні. Вгадай, яка правильна.
3. Запиши коротко
Поклади факт на потрібну поличку. Або на пару поличок, якщо він справді потрібен в обох місцях. Коротко й по суті: одна нотатка - один факт.
4. Онови зміст
Є файл-зміст або зведення? Впиши туди новий запис, щоб його потім було легко знайти.
База знань агента: плюси й типові провали
- Факти й рішення лежать у файлах, а не в одному старому листуванні.
- Нотатки короткі й по суті: одна нотатка = один факт.
- Перед записом ти шукаєш дубль і оновлюєш старе, а не плодиш нове.
- У кожного факту одна домівка - жодних пʼяти копій у різних місцях.
- Імена файлів зрозумілі та однакові (маленькими літерами через дефіс).
- База перетворюється на смітник - агент гає час на читання сміття.
- Суперечливі нотатки: в одній «роби так», в іншій «ніколи так не роби».
- У файл потрапили секрети (паролі, ключі) - а файл потім витік.
- Агент вірить старому запису, хоча в проєкті все давно змінилося.
- Один гігантський файл-простирадло, у якому неможливо нічого знайти.
Памʼять треба прополювати, а не лише наповнювати
Ось пастка, в яку падають майже всі: завели базу знань - і тільки додають. Ніколи не чистять. За пару місяців це город, що заріс бурʼяном: десь морквина (потрібний факт), а навколо бурʼяни (застаріле, дублі, сміття).
Скіл knowledge-ops каже прямо: тримай нотатки короткими, архівуй старе, не давай файлам розпухати без меж. Перш ніж вважати задачу закритою, прожени себе по короткому чек-листу.
- Немає дублів: один факт живе в одному місці.
- Секрети вичищені з усього, що може потрапити в спільний доступ.
- Зміст і зведення оновлені після змін.
- Застаріле видалено або пішло в архів, а не лежить поряд із актуальним.
- Десять нотаток про одне й те саме, і яка правильна - незрозуміло.
- У нотатках лежить ключ від API «щоб не забути» - це діра.
- Файли ростуть без меж, ніхто їх не чистив пів року.
- Старий факт суперечить новому, а агент натикається на старий.
Приклад із життя: сайт кавʼярні без памʼяті
Робиш з агентом сайт для кавʼярні. День перший: обрали шрифт, палітру, тон текстів, домовилися не чіпати стару CMS. Краса.
За тиждень відкриваєш нову сесію: «давай доробимо сайт кавʼярні». А агент - чистий аркуш. Ні шрифту, ні палітри, ні про CMS - нічого. Ти переказуєш усе наново, дорогою плутаєшся сам, і ось у тебе вже два різних шрифти на двох сторінках.
Що пішло не так? Усі рішення жили тільки в листуванні першого дня. Нова сесія - нова амнезія.
А як робить вайбкодер, який дочитав цей урок: один раз заводить агенту базу знань і просить її вести.
Заведи й веди базу знань цього проєкту. Зроби так:
- Створи файл із фактами проєкту (project-facts) і файл із рішеннями
(decisions). Імена - маленькими літерами через дефіс.
- У факти запиши: назву, мову текстів, дедлайн, контакти.
- У рішення записуй не лише ЩО вирішили, а й ЧОМУ
(наприклад: шрифт Fraunces, бо потрібен дорогий вінтажний вигляд).
- Перш ніж додати новий факт - спершу пошукай, чи немає його вже.
Якщо є, онови старий запис, а не створюй другий.
- Не клади в ці файли паролі, ключі й токени.
- На початку кожної нової сесії спершу прочитай ці два файли,
а потім берися за задачу.
Часті помилки новачка з базою знань
- Зберігати рішення лише в чаті. Нова сесія - і їх немає. Виноси у файли.
- Тільки додавати, ніколи не чистити. База заростає сміттям і дублями.
- Не шукати перед записом. Отримуєш пʼять нотаток про один факт, а яка правильна - загадка.
- Звалити все в один величезний файл. Знайти щось у простирадлі на тисячу рядків нереально - розділи за змістом.
- Класти секрети «щоб не забути». Ключ у спільному файлі = діра в безпеці.
- Записати «що вирішили» без «чому». За місяць переробиш по колу, бо забув причину.
TL;DR - если коротко
- Памʼять агента живе у файлах, а не в нього в голові. Немає файлу - після перезапуску немає й факту.
- База знань - це кілька поличок: швидкі нотатки, довгі документи, пошук за змістом. У кожної своя робота.
- Золоте правило: спершу знайди, потім пиши. Один факт - одна домівка, без дублів і без брехні самому собі.
- Памʼять треба прополювати. Застаріле - в архів, а не в купу. Смітник шкодить не менше за порожню голову.
- Кладеш файл у спільний доступ? Спершу вичисти секрети - паролі, ключі. Зі спільного вони витікають першими.
- Почни з двох поличок - факти й рішення. Це знімає більшу частину болю, решту додаси потім.