AiHummer
Polski
Zaloguj sięKonto
v1.0.x
{ }Swagger

Einstein (wtyczka pamięci)

v1.0.x · zaktualizowany 2026-07-05

Einstein jest oficjalnym wtyczką pamięci długoterminowej dla AiHummer. Daje agentowi trwałą, przeszukiwalną pamięć, która przetrwa ponowne uruchomienia i rozmowy, nie zamieniając tej pamięci w czarną skrzynkę. Zasada przewodnia jest prosta: PostgreSQL jest systemowym magazynem, a kanoniczny Markdown jest jego czytelną dla człowieka projekcją, a system indeksuje i proponuje zmiany. W trybie review każda promocja do pamięci długotrwałej jest przeglądana przez człowieka; w trybie auto (domyślnym) fakt zapisany przez agenta jawnie narzędziem memory_store staje się przeszukiwalny od razu.

Wtyczka działa natywnie na hoście jako własna mała usługa Pythona (tylko biblioteka standardowa — bez ciężkich frameworków) i komunikuje się z bramą przez aihummer.memory.v1 umowa. Podsystem pamięci w bramce wejściowej (roszczenia, przywołanie, zapora danych) jest opisany na stronie koncepcji Pamięć (Einstein); ta strona obejmuje wtyczka który to popiera.

Fakty

Pole Wartość
Wersja 1.0.0
Port 8820
Czas wykonywania Python (biblioteka standardowa), natywny dla hosta

Czym to jest

Einstein przechowuje pamięć jako Markdown czytelny dla człowieka — kanoniczny zapis, który osoba może otworzyć, przeczytać i edytować. Na szczycie tego zapisu buduje mechanizm, którego agent potrzebuje w danym momencie:

  • Pozyskiwanie — pobierz pamięć istotną dla bieżącej rozmowy.
  • Szukaj — pełnotekstowe i oparte na osadzaniu wyszukiwanie wśród przechowywanych faktów.
  • Osadzenia — wektory do przypominania semantycznego, serwowane przez HTTP.

Ponieważ Markdown jest kanoniczny, nic w indeksach nie jest cenne: można je w każdej chwili odbudować z tego kanonicznego zapisu, a recenzent zawsze czyta ten sam tekst, który czyta agent.

Jak jest używane

W czasie tury brama pyta Einsteina o pamięć istotną dla bieżącego kontekstu. Przypomnienie jest dostarczane modelowi jako wynik narzędzia opakowany w barierę danych, nigdy jako wstrzyknięte instrukcje — więc złośliwa notatka, która trafiła do pamięci, nie może przejąć agenta. Nowe fakty zaobserwowane w rozmowie są wyodrębniane jako roszczenia z dowodami i oczekujące na przegląd, zamiast być zapisywane bezpośrednio do pamięci.

Istnieje też druga ścieżka: agent może sam zapisać fakt narzędziem memory_store. O tym, jak taki zapis wyląduje, decyduje rdzeniowy tryb zbierania pamięci — przy auto (domyślnym) fakt jest przeszukiwalny natychmiast; przy review lub off staje się kandydatem oczekującym na zatwierdzenie. Wynik narzędzia zawiera pole searchable_now, więc agent może uczciwie powiedzieć, czy dopiero co zapisany fakt da się już przywołać.

[!NOTE] System indeksuje i proponuje, ale nigdy nie przepisuje pamięci w ciszy. W trybie review promowanie twierdzenia do pamięci długotrwałej jest działaniem celowym, przeglądanym przez człowieka; w trybie auto (domyślnym) fakty zapisane jawnie przez agenta są przeszukiwalne od razu. Tryb pamięci (auto / review / off) i tryb wyszukiwania (fulltext / embedding) to ustawienia rdzenia (AIHUMMER_MEMORY_CAPTURE / AIHUMMER_MEMORY_RETRIEVAL w katalogu ustawień), a nie formularz wtyczki.

Platforma pamięci v2 (domyślnie włączona)

Einstein wysyła pełny platforma pamięci v2, i cała jego moc jest poza pudełkiem — nic nie trzeba łączyć ręcznie: ekstrakcja roszczeń, kolejka przeglądowa, procesor w tle (fakty, linki i podmioty z dowodów), przejście „marzenie”/konsolidacyjne (usuwanie duplikatów i samonaprawa pamięci), graf pamięci i wykrywanie sprzeczności. Tryb pamięci, osadzacz i magazyn wektorów są konfigurowane osobno, jako ustawienia rdzenia. Sam Einstein jest konfigurowany przez dostawcę: wtyczka nie udostępnia żadnych ustawień operatorskich, a na stronie Wtyczki dostępna jest tylko jej akcja aktualizacji.

[!NOTE] Jedynym ludzkim krokiem jest zatwierdzanie zapisu do pamięci kanonicznej (MEMORY.md). Każdy pracownik v2 zapisuje tylko do osobnego magazynu sidecar i nigdy nie dotyka kanoniczny Markdown. Kiedy Einstein opracowuje edycję wartą włączenia do kanonu, jest ona wyświetlana w interfejsie przeglądu i stosowana jednym kliknięciem. Więc cała moc jest dostępna od razu, a jednocześnie rdzeniowa gwarancja obowiązuje: pamięć nigdy nie jest przepisywana za twoimi plecami. To decyzja produktowa, a nie ustawienie operatorskie.

Instalacja

Einstein jest wbudowany wtyczka: instaluje się automatycznie dla każdego najemcy, przenosi Wbudowany odznaka na liście wtyczek i nie można usunąć — pamięć jest częścią rdzenia produktu. Sam moduł jest zawsze obecny, ale zbieranie pamięci można wyłączyć: tryb pamięci off (rdzeniowe ustawienie AIHUMMER_MEMORY_CAPTURE) zatrzymuje zbieranie nowych wspomnień bez usuwania modułu. Nie ma nic do instalowania osobno; pełny cykl życia zwykłych wtyczek jest opisany w Instalacja i aktualizacje. Nie ma kontenerów — Einstein działa jako własna usługa systemd obok bramy.

Bezpieczeństwo i ograniczenia

  • Kanoniczny Markdown jest czytelną projekcją. Sklep systemowy jest PostgreSQL; indeksy i osadzenia są wyprowadzalne; tekst kanoniczny to to, co ludzkie recenzje i poprawki.
  • Żadnych cichych poprawek. Platforma v2 działa od razu po wyjęciu z pudełka, ale zapis do kanonu przechodzi przez zatwierdzenie przez człowieka jednym kliknięciem; pracownicy piszą tylko do sidecara i nigdy nie dotykają kanonicznego Markdown.
  • Przypomnienie ograniczone danymi. Pamięć dociera do modelu jako wyodrębniony wynik narzędzia, nigdy jako instrukcje, które blokują pośrednie wstrzykiwanie poleceń.
  • Zabezpieczony interfejs webowy. Interfejs przeglądu/zarządzania wtyczką jest chroniony dostępem.
  • Natywny dla hosta. Działa pod systemd, nie w kontenerze.

Dokąd dalej