3. Описание MCP-сервера › 3.4 Память › Концепция

Семья memory — память агента о магазине: заметки, которые лежат в базе магазина, а не на компьютере и не в переписке. Следующая сессия — на другом компьютере, в другом приложении-агенте — встретит те же заметки. Как память выглядит для людей — «AI-помощник». Рабочие данные, которые нужны позже или другим ассистентам, хранит «Репозиторий».

Уровни

Уровень, `level`	Кто читает	Кто пишет
`all` — для всех	все пользователи магазина	администратор
`group` — для группы	пользователи этой группы	администратор
`own` — свои	пользователь, под которым вошёл агент	агент, инструментом `memory_save`

Свои заметки принадлежат пользователю, под которым вошёл агент: у другого пользователя память своя. Заметки для групп и для всех пишет администратор — в программе или записью в таблицу agent_memory; memory_save и memory_remove до них не достают.

Кому заметку не показывать, администратор пишет в поле for_skip: логины и ключи групп через пробел, запятую или точку с запятой. Сервер такую заметку этим логинам не отдаёт: её нет ни в списке, ни среди критических, которые надо прочесть.

Виды

У каждой заметки есть вид kind_key из реестра магазина — строк key_value с кодом AGENT_MEMORY_KIND_KEY:

Вид	Что это
`kCritical`	что должно соблюдаться в каждой сессии
`kDirect`	распоряжение человека
`kSkill`	как работать с этим человеком
`kDefault`	всё остальное

Владелец может добавить в реестр свои виды, они считаются как kDefault. Вид, которого в реестре нет, сохранение не принимает.

Критические заметки читаются первыми. session_connect сообщает, сколько их; пока все они не загружены через memory_load, сервер отказывает во всех командах, кроме memory_list и memory_load.

Старшинство, когда заметки расходятся: сначала уровень, внутри него вид.

kCritical, kDirect, kSkill для всех;
kCritical, kDirect, kSkill для группы;
свои kCritical, kDirect, kSkill;
все остальные заметки.

Заметка

Поле	Что это
`id`	номер заметки
`name`	короткое название
`category`	свободные слова, по которым заметки группируются
`info`	одна строка описания — её показывает список
`kind_key`	вид
`body`	текст в простом HTML: `<p>`, `<ul>` и `<li>`, `<b>`, `<code>`

Список идёт по уровням — для всех, для групп, свои, — внутри по категории, а новая заметка встаёт последней.

В программе

Вся память видна и правится в «Проектирование → AI-компоненты», на вкладке «AI-память»; кто может открыть это окно, видит заметки всех пользователей. Окно берёт таблицу agent_memory в работу, как только открывается, и пока оно открыто, memory_save и memory_remove отказывают.

Подписи на оригинальном языке могут отличаться.

Правила

Отдельного файла правил и порога у семьи нет: правила памяти приходят вместе с правилами сессии в ответе session_connect.