AiHummer
Беларуская
Увайсці
v1.0.x
{ }Swagger

Einstein (плагін памяці)

v1.0.x · абноўлена 2026-07-07

Einstein — гэта афіцыйны плагін доўгатэрміновай памяці для AiHummer. Ён дае агенту трывалую памяць з магчымасцю пошуку, якая перажывае перазапускі і размовы, ніколі не ператвараючы гэтую памяць у чорную скрыню. Кіруючае правіла простае: кананічны Markdown — крыніца ісціны, сістэма індэксуе і прапануе змены, а кожнае прасоўванне ў доўгатэрміновую памяць правяраецца чалавекам.

Плагін працуе host-native як уласны невялікі Python-сэрвіс (толькі стандартная бібліятэка — без цяжкавагавых фрэймворкаў) і размаўляе са шлюзам праз кантракт . Падсістэма памяці ўнутры шлюза (claims, recall, data-fence) апісана на старонцы канцэпцыі Памяць (Einstein); гэтая старонка ахоплівае плагін, які яе падтрымлівае.

Факты

Field Value
Версія 1.0.0
Порт 8820
Асяроддзе выканання Python (стандартная бібліятэка), host-native

Што гэта

Einstein захоўвае памяць як чытэльны для чалавека Markdown — кананічны запіс, які чалавек можа адкрыць, прачытаць і адрэдагаваць. На вяршыні гэтага запісу ён будуе механізмы, неабходныя агенту падчас ходу размовы:

  • Выманне — атрыманне памяці, рэлевантнай бягучай размове.
  • Пошук — паўнатэкставы і заснаваны на эмбедынгах пошук па захаваных фактах.
  • Эмбедынгі — вектары для семантычнага ўспаміну, што абслугоўваюцца праз HTTP.

Паколькі Markdown з’яўляецца кананічным, нічога ў індэксах не з’яўляецца каштоўным: яны могуць быць перабудаваны з крыніцы ісціны ў любы момант, і рэцэнзент заўсёды чытае той самы тэкст, які чытае агент.

Як гэта выкарыстоўваецца

Падчас ходу размовы шлюз запытвае ў Einstein памяць, рэлевантную бягучаму кантэксту. Успамін дастаўляецца мадэлі як вынік інструмента, абгорнуты ў data-fence, ніколі як убудаваныя інструкцыі — таму шкоднасная нататка, якая трапіла ў памяць, не можа захапіць агента. Новыя факты, заўважаныя ў размове, вымаюцца як claims з доказамі і ставяцца ў чаргу на праверку, а не запісваюцца адразу ў памяць.

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

Платформа памяці v2 (уключана з скрынкі)

Einstein пастаўляецца з поўнай платформай памяці v2, і ўся яе моц уключана і працуе адразу пасля ўсталявання — нічога дапрацоўваць уручную не трэба: выманне claims, чарга праверкі, фонавы дэрывер (факты, сувязі, сутнасці са сведчанняў), праход “dream”/кансалідацыі (дэдуплікацыя і самавылячэнне памяці), граф памяці і выяўленне супярэчнасцей. Фонавы планіроўшчык па змаўчанні працуе з інтэрвалам 900 с. Усе флагі наладжваюцца ў адмінцы (Web UI), але змяняць іх для паўнавартаснай працы не трэба.

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

Усталяванне

Einstein — убудаваны плагін: ён усталёўваецца аўтаматычна для кожнага арандатара, пазначаны ў спісе плагінаў значком «Убудаваны» і не можа быць выдалены або спынены — памяць з’яўляецца часткай ядра прадукту. Асобна ўсталёўваць яго не трэба; поўны жыццёвы цыкл звычайных плагінаў апісаны на старонцы Усталяванне і абнаўленні. Кантэйнераў няма — Einstein працуе як уласны systemd-сэрвіс побач са шлюзам.

Бяспека і абмежаванні

  • Крыніца ісціны — Markdown. Індэксы і эмбедынгі вытворныя; кананічны тэкст — гэта тое, што чалавек правярае і рэдагуе.
  • Без маўклівых перапісванняў. Платформа v2 працуе з скрынкі, але запіс у канон праходзіць зацвярджэнне чалавекам адным клікам (reviewed_ui); воркеры пішуць толькі ў sidecar і не чапаюць кананічны Markdown.
  • Успамін з data-fence. Памяць дасягае мадэлі як абгароджаны вывад інструмента, ніколі як інструкцыі, што блакіруе ўскосную інʼекцыю промпта.
  • Абаронены Web UI. Інтэрфейс праверкі/кіравання плагіна мае кантроль доступу.
  • Host-native. Працуе пад systemd, а не ў кантэйнеры.

Куды далей