Мозг проекта — слой знаний в границах одного проекта. Он сочетает векторный и лексический поиск по каноническим файлам репозитория с управляемой памятью, накопленной во время поставки. Платформенные агенты получают чтение или право предлагать изменения только через явные разрешения проекта.

​
Что потребуется

  • Postgres с pgvector и применёнными миграциями Мозга проекта.
  • Общие настройки поставщиков эмбеддингов и дистилляции.
  • Включённый Мозг проекта.
  • Для агента — явное право чтения или записи на его связи с проектом.
Источники, индексация и управляемые знания Мозга проекта

​
Два слоя знаний

Если для решения или направления задан канонический файл, агент предлагает правку этого источника, а не создаёт конкурирующую запись памяти.

​
Настройте поставщиков

Глобальный администратор открывает Настройки → Поставщики Мозга проекта и задаёт:
  • базовый адрес, модель, размерность и ссылку env:NAME на ключ эмбеддингов;
  • при необходимости отдельные адрес, модель и ключ для дистилляции;
  • без отдельной настройки дистилляция использует тот же маршрут поставщика.
Сам секрет хранится в окружении веб-сервиса. Смена модели или размерности создаёт новое неизменяемое поколение эмбеддингов и ставит переиндексацию в очередь, а не переписывает старые векторы.

​
Включите Мозг проекта

Откройте Проект → Настройки → Мозг проекта. Включение не пройдёт, пока настройки эмбеддингов и дистилляции неполны. После этого управляйте источниками на вкладке Проект → Мозг проекта. Источник задаётся относительным к репозиторию путём или ограниченной маской. MAIster читает отслеживаемые файлы из основной ветки, разбирает их типизированным обработчиком, сохраняет указатели и выдержки, затем создаёт векторы. Игнорируемые, неотслеживаемые, абсолютные и выходящие за репозиторий пути отклоняются. Индексацию выполняют задания планировщика. Событие репозитория может поставить источник в очередь, а оператор — запустить обработку вручную. Для каждого источника видны время последней индексации и точная ошибка файла, маски, обработчика или поставщика.

​
Поиск и использование контекста

Один запрос объединяет:
  • векторную близость в активном поколении эмбеддингов;
  • лексический рейтинг по индексу и собственной памяти;
  • уверенность и правила жизненного цикла сохранённых записей.
При чтении не вызывается генеративная модель. Результат содержит ограниченную выдержку и ссылку на канонический источник. Потребление записывается, поэтому можно понять, какой контекст использовал агент. Flow и платформенные агенты могут получать найденный контекст для планирования, проверки и анализа. Доступ остаётся проектным: знания одного репозитория не подмешиваются в другой без явной связи.

​
От наблюдения к улучшению

После прогонов, срабатываний проверок и повторяющихся ошибок агент может предложить:
  • новую запись памяти;
  • усиление или ослабление существующего урока;
  • изменение канонической документации, навыка, инструкции агента или другого проектного артефакта.
Предложение не публикуется напрямую. Человек видит источник, обоснование, область изменения и возможный конфликт, после чего принимает, изменяет или отклоняет его. Так память и проектные или агентские артефакты совершенствуются без скрытых записей в репозиторий.

​
Платформенные агенты

Платформенный агент — устанавливаемый пакет с версионированными инструкциями, навыками, возможностями и политикой запуска. Он может следить за ошибками, обрабатывать события, поддерживать проектные знания или выполнять иные системные задачи вне пользовательского Flow. Назначение проекта определяет режим запуска, разрешения Мозга, MCP и другие возможности. Каждый запуск создаёт обычный наблюдаемый прогон с событиями, расходом, доказательствами и ограничениями бюджета. Контроль запросов на слияние устроен точнее: состояние наблюдает планировщик, а при конфликте он запускает отдельную ограниченную ACP-сессию для разрешения конфликта. Это не постоянно работающий встроенный агент. Каталог и назначения платформенных агентов

​
Признаки проблемы

  • Мозг проекта нельзя включить — завершите общую настройку поставщиков.
  • Источник не индексируется — исправьте указанный путь, маску, обработчик или доступ к поставщику.
  • Поиск не видит новую версию — дождитесь задания нового поколения и проверьте, что источник успешно переиндексирован.
  • Агент не получает контекст — проверьте связь с проектом и разрешение чтения.
  • Предложение не применяется — оно требует решения человека или конфликтует с каноническим источником.

​
Связанные страницы