Einstein (плагин памяти)

Einstein — официальный плагин долговременной памяти AiHummer. Он даёт агенту устойчивую, доступную для поиска память, которая переживает перезапуски и переключение разговоров, и при этом память никогда не превращается в «чёрный ящик». Главное правило простое: источник истины — канонический Markdown, система индексирует и предлагает изменения, а каждое продвижение в долговременную память проходит проверку человеком.

Плагин работает host-native как отдельный небольшой Python-сервис (только стандартная библиотека — без тяжёлых фреймворков) и общается с gateway по контракту aihummer.memory.v1. Подсистема памяти внутри gateway (claims, выдача, data-fence) описана на странице концепции Память (Einstein); эта страница — про сам плагин, который её обеспечивает.

Факты

Поле	Значение
Версия	1.0.0
Порт	8820
Среда	Python (стандартная библиотека), host-native

Что это такое

Einstein хранит память в виде человекочитаемого Markdown — канонической записи, которую человек может открыть, прочитать и отредактировать. Поверх этой записи он строит механизмы, нужные агенту в момент хода:

Выдача (retrieval) — получить память, релевантную текущему разговору.
Поиск — полнотекстовый и по эмбеддингам поиск по сохранённым фактам.
Эмбеддинги — векторы для семантической выдачи, отдаются по HTTP.

Поскольку Markdown каноничен, в индексах нет ничего незаменимого: их можно перестроить из источника истины в любой момент, и проверяющий всегда читает тот же текст, что и агент.

Как используется

В момент хода gateway запрашивает у Einstein память, релевантную текущему контексту. Выдача приходит модели как результат инструмента, обёрнутый в data-fence, а не как внедрённые инструкции — поэтому вредоносная заметка, попавшая в память, не может перехватить управление агентом. Новые факты, замеченные в разговоре, извлекаются как утверждения (claims) с доказательствами и ставятся в очередь на проверку, а не пишутся в память напрямую.

[!NOTE] Система индексирует и предлагает, но никогда тихо не переписывает память. Продвижение утверждения в долговременную память — это осознанный шаг с проверкой человеком. Режим памяти (auto / review / off) и режим выдачи (fulltext / embedding) настраиваются в админке.

Платформа памяти v2 (включена из коробки)

Einstein поставляется с полной платформой памяти v2, и вся её мощь включена и работает сразу после установки — ничего доводить руками не нужно: извлечение утверждений, очередь проверки, фоновый деривер (факты, связи, сущности из свидетельств), проход «сна»/консолидации (dream, дедупликация и самоисцеление памяти), граф памяти и обнаружение противоречий. Фоновый планировщик по умолчанию работает с интервалом 900 с. Все флаги настраиваются в админке (Web UI), но менять их для полноценной работы не требуется.

[!NOTE] Единственный человеко-шаг — одобрение записи в каноническую память (MEMORY.md). Все воркеры v2 пишут только в отдельное sidecar-хранилище и никогда не трогают канонический Markdown. Когда Einstein выводит правку, которую стоит зафиксировать в канон, она показывается в UI проверки и применяется одним кликом (режим reviewed_ui, по умолчанию). Так вся мощь доступна сразу, но базовая гарантия сохраняется: память никогда не переписывается у вас за спиной. При желании оператор может выбрать preview_only (только показывать правки) в настройке EINSTEIN_CANONICAL_MEMORY_WRITE_MODE.

Установка

Einstein — встроенный плагин: он устанавливается автоматически для каждого арендатора, помечен в списке плагинов бейджем «Встроенный» и не может быть удалён или остановлен — память является частью ядра продукта. Отдельно устанавливать его не нужно; полный жизненный цикл обычных плагинов описан на странице Установка и обновления. Никаких контейнеров — Einstein работает как собственный systemd-сервис рядом с gateway.

Безопасность и ограничения

Источник истины — Markdown. Индексы и эмбеддинги выводимы; человек проверяет и редактирует именно канонический текст.
Без тихих перезаписей. Платформа v2 работает из коробки, но запись в канон проходит одобрение человеком одним кликом (reviewed_ui); воркеры пишут только в sidecar и не трогают канонический Markdown.
Выдача в data-fence. Память доходит до модели как огороженный вывод инструмента, а не как инструкции, что блокирует косвенные инъекции в промпт.
Защищённый Web UI. UI проверки/управления плагина закрыт контролем доступа.
Host-native. Работает под systemd, не в контейнере.