Перейти к содержимому
MMW · Документация

Конфликты и сводки

Из этой страницы вы узнаете:

  1. когда запись получает статус conflict и почему MMW ничего не перезаписывает молча;
  2. как сделать сводку через derived_from, чтобы она не скрывала противоречий;
  3. как разрешить конфликт.

Пример на всю страницу: в понедельник агент Анны сохранил, что staging выкатывается через systemd-юнит app-staging. В четверг агент Бориса сохранил, что staging теперь выкатывается через Docker Compose. Кто прав — решать людям, а не памяти.

Записи сравниваются по fact_key. Если в одной рабочей области есть несколько записей с одинаковым ключом, но разным содержимым или хешем источника, все они получают статус conflict.

workspace default, fact_key = deploy.staging.method
────────────────────────────────────────────────────────────────
A пн «через systemd-юнит app-staging» → conflict
B чт «через Docker Compose, сервис staging» → conflict
  • Ничего не перезаписывается. remember всегда добавляет новую запись, даже с тем же ключом. Старая версия остаётся и помечается.
  • Конфликт виден обеим сторонам. Помечается не только старая, но и новая запись: сервер не знает, какая из них верна.
  • Новейшая версия — первой. В search самая новая запись с этим ключом стоит выше старых, даже если старая совпадает с запросом лучше. Если запросу соответствует только старая версия, новая подтягивается в выдачу рядом с ней. У старых версий поле superseded_by содержит ID новейшей.
  • Одинаковый текст — не конфликт. Если та же формулировка сохранена повторно с тем же хешем источника, расхождения нет.
  • Тот же текст с новым хешем — конфликт. Если документ изменился и вы пересохранили факт с новым source_hash, не удалив старый, версии разойдутся по хешу. Сначала удалите старое — см. Источник и свежесть.
  • Границы. Сравниваются только записи одной рабочей области, которые вы можете видеть. Записи без fact_key в конфликт не попадают.
search: «как выкатывается staging»
[
{
"id": "b3e1…",
"content": "staging выкатывается через Docker Compose, сервис staging",
"fact_key": "deploy.staging.method",
"status": "conflict",
"created_at": "2026-10-08T14:03:00+00:00"
},
{
"id": "a7d2…",
"content": "staging выкатывается через systemd-юнит app-staging",
"fact_key": "deploy.staging.method",
"status": "conflict",
"superseded_by": "b3e1…",
"created_at": "2026-10-05T09:12:00+00:00"
}
]

Новейшая версия — это подсказка, а не вердикт. Если новую запись сохранили как исправление, это видно по superseded_by; если нет уверенности, правильная реакция агента — не выбирать вариант по дате, а сказать человеку: «В памяти два противоречащих факта о выкатке staging: от 5 и от 8 октября. Какой актуален?»

Со временем записей становится много, и агент сжимает их в сводку. Чтобы сводка не стала «чистой» версией с потерянными противоречиями, передайте ID исходных записей в derived_from:

remember
{
"content": "Итоги недели по деплою: staging переводится на Docker Compose; миграции запускаются make migrate до выкатки",
"fact_key": "deploy.weekly-summary.2026-w41",
"derived_from": ["a7d2…", "b3e1…", "c9f0…"]
}
  • в derived_from — до 50 ID, и только существующих записей, которые вы видите; иначе ошибка derived_from contains unknown memory ids;
  • в результатах search у сводки есть поле derived_from со списком источников;
  • сводка наследует худший статус своих источников: если хоть один из них в conflict или stale, сводка тоже. Наследование проходит до трёх уровней (сводка сводок тоже видит проблему).

В нашем примере сводка получит статус conflict, хотя её собственный текст ни с чем не спорит: противоречие в её основе не решено.

Раздел «База знаний» показывает у каждой записи одно понятное состояние — оно считается по тем же правилам, но для людей, а не для агентов:

СостояниеЧто значит
АктуальноДругих версий этого факта нет, или все они совпадают.
Версии расходятсяСамая новая версия ключа, у которого версии различаются текстом или хешем источника. Её получают агенты — с пометкой conflict.
ЗамененоБолее старая версия того же fact_key. Агенты получают новую; в паспорте видно, какую.
УстарелоЗапись со статусом stale — в том числе историческая отметка до Core.

Главный экран кабинета «Память» начинается с этих записей — блок «Требует решения». Фильтр «Требует решения» в базе знаний собирает записи «Версии расходятся» и «Устарело» — это то, что стоит проверить человеку. Счётчики над таблицей учитывают только записи, которые вы можете читать: чужой черновик в организации не сделает факт спорным и не появится в паспорте.

Нажмите на запись — откроется «Паспорт факта»: когда и кем она записана, источник и его хеш, ключ факта, вся история версий (какую из них сейчас получают агенты) и связи архивариуса «заменяет / заменено». В паспорте можно принять решение:

  • «Верна эта версия» — у записей «Версии расходятся» и «Заменено». После подтверждения остальные версии этого факта, которые вы видите, удаляются так же мягко, как через forget: пропадают из поиска, факт удаления остаётся в журнале. Агенты больше не видят расхождения.
  • «Ещё актуально» — у записей «Устарело». Запись возвращается в обычный статус.

Решение пишется в журнал запросов кабинета без текста записей. В организации решать может автор записи, тот, кому переданы его знания, руководитель подразделения записи или администратор организации; подрядчики и аудиторы — нет. Если хотя бы одну из затронутых версий вы менять не вправе, не меняется ничего.

На главном экране «Память» каждая запись из «Требует решения» показана как простой вопрос:

  • «В памяти две разные записи об одном и том же. Какая верная?» — варианты стоят рядом, слова, которыми они отличаются, подчёркнуты. Под каждым — кнопка «Верна эта». Ещё два ответа: «Обе верны — это разные вещи» (записи остаются, но больше не считаются версиями одного факта) и «Пока не знаю» (вопрос вернётся через неделю).
  • «Это ещё правда?» — для записи, помеченной устаревшей. Ответы: «Да, ещё правда», «Нет, удалить» и «Пока не знаю».

Удаление и «разные вещи» срабатывают только после подтверждения.

«Помочь разобраться» — AI-помощник MMW. По вашему запросу сервер передаёт разрешённые тексты внешней модели. Она формулирует вопрос; вы проверяете источник и принимаете решение обычными кнопками.

  1. Выясните, какая версия верна. Спросите человека или перечитайте источник. Не решайте по дате: более новая запись не обязательно правильная.

  2. Удалите неверную версию через forget по её ID:

    forget
    { "memory_id": "a7d2…", "workspace": "default" }

    Удаление мягкое: запись пропадает из поиска и графа, факт удаления остаётся для аудита.

  3. Проверьте результат. В следующем search запись B уже unverified: у ключа осталась одна версия.

  4. Обновите сводку при необходимости. Удалённые источники больше не влияют на статус сводки, поэтому, если у остальных источников всё в порядке, она тоже станет unverified. Но её текст мог опираться на неверную версию — если так, сохраните новую сводку и удалите старую.

AI-Архивариус MMW организует новые разрешённые записи. Правила fact_key и хеша источника работают независимо от него; ответ модели не делает факт подтверждённым.