База знаний для ИИ-агента: как дать ему память

Что такое база знаний агента простыми словами

Представь гениального стажёра. Умный, быстрый, схватывает на лету. Один нюанс: каждое утро он приходит с полной амнезией. Не помнит, как тебя зовут. Не помнит, что вы делали вчера, какой шрифт выбрали и почему решили НЕ трогать ту страшную папку.

Что делает нормальный начальник? Точно не пересказывает всё заново каждое утро - так и до выгорания недалеко. Он заводит стажёру тетрадку с главными фактами: «клиента зовут так-то», «шрифт - 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 говорит прямо: держи заметки короткими, архивируй старое, не давай файлам пухнуть без предела. Прежде чем считать задачу закрытой, прогони себя по короткому чек-листу.

Пример из жизни: сайт кофейни без памяти

Делаешь с агентом сайт для кофейни. День первый: выбрали шрифт, палитру, тон текстов, договорились не трогать старую CMS. Красота.

Через неделю открываешь новую сессию: «давай доделаем сайт кофейни». А агент - чистый лист. Ни шрифта, ни палитры, ни про CMS - ничего. Ты пересказываешь всё заново, по дороге путаешься сам, и вот у тебя уже два разных шрифта на двух страницах.

Что пошло не так? Все решения жили только в переписке первого дня. Новая сессия - новая амнезия.

А как делает вайбкодер, который дочитал этот урок: один раз заводит агенту базу знаний и просит её вести.

Заведи и веди базу знаний этого проекта. Сделай так:

Создай файл с фактами проекта (project-facts) и файл с решениями
(decisions). Имена - маленькими буквами через дефис.
В факты запиши: название, язык текстов, дедлайн, контакты.
В решения записывай не только ЧТО решили, но и ПОЧЕМУ
(например: шрифт Fraunces, потому что нужен дорогой винтажный вид).
Перед тем как добавить новый факт - сначала поищи, нет ли его уже.
Если есть, обнови старую запись, а не создавай вторую.
Не клади в эти файлы пароли, ключи и токены.
В начале каждой новой сессии сперва прочитай эти два файла,
а потом берись за задачу.

Частые ошибки новичка с базой знаний

• Хранить решения только в чате. Новая сессия - и их нет. Выноси в файлы.
• Только добавлять, никогда не чистить. База зарастает мусором и дублями.
• Не искать перед записью. Получаешь пять заметок про один факт, а какая верная - загадка.
• Свалить всё в один огромный файл. Найти что-то в простыне на тысячу строк нереально - раздели по смыслу.
• Класть секреты «чтобы не забыть». Ключ в общем файле = дыра в безопасности.
• Записать «что решили» без «почему». Через месяц переделаешь по кругу, потому что забыл причину.