AiHummer
Türkçe
Oturum açHesap
v1.2.x
{ }Swagger

Einstein (hafıza eklentisi)

v1.2.x · güncellendi 2026-07-05

Einstein, AiHummer için resmi uzun süreli hafıza eklentisidir. Bir ajana, yeniden başlatmalardan ve konuşmalardan sonra bile devam eden, aranabilir bir hafıza sağlar ve bu hafızayı asla bir kara kutuya dönüştürmez. Yönlendirici kural basittir: PostgreSQL sistem deposudur ve kanonik Markdown onun insan tarafından okunabilir projeksiyonudur, sistem değişiklikleri dizinler ve önerir. review modunda uzun vadeli belleğe yapılan her yükseltme bir insan tarafından incelenir; auto modunda (varsayılan) ajanın memory_store aracıyla açıkça kaydettiği bir gerçek hemen aranabilir hale gelir.

Eklenti, kendi küçük Python servisi olarak ana bilgisayarın üzerinde çalışır (sadece standart kütüphane — ağır bir çerçeve yok) ve ağ geçidi ile iletişim kurar aihummer.memory.v1 sözleşme. Giriş geçidi bellek alt sistemi (talepler, geri çağırma, veri çiti) kavram sayfasında açıklanmıştır Bellek (Einstein); bu sayfa şunu kapsar eklenti onu destekleyen.

Gerçekler

Alan Değer
Sürüm 1.0.0
Liman 8820
Çalışma zamanı Python (standart kütüphane), ev sahibi-yerel

Ne olduğu

Einstein belleği olarak depolar insan tarafından okunabilir Markdown — bir kişinin açabileceği, okuyabileceği ve düzenleyebileceği kanonik kayıt. Bu kaydın üzerine, bir temsilcinin sıra zamanı ihtiyaç duyduğu mekanizmayı inşa eder:

  • Geri Getirme — mevcut konuşmayla ilgili belleği getir.
  • Ara — depolanan bilgiler üzerinde tam metin ve gömme tabanlı arama.
  • Gömülü Temsiller — anlamsal geri çağırma için vektörler, HTTP üzerinden sunuluyor.

Markdown kanonik olduğu için, dizinler ile ilgili hiçbir şey değerli değildir: onlar her zaman bu kanonik kayıttan yeniden oluşturulabilir ve bir gözden geçirici her zaman ajanın okuduğu aynı metni okur.

Nasıl kullanılır

Sıra zamanı geldiğinde geçit, Einstein’dan mevcut bağlamla ilgili belleği ister. Hatırlama modele iletilir veri çiti içinde sarılmış bir araç sonucu olarak, asla enjekte edilmiş talimatlar olarak — bu yüzden belleğe sızmış kötü niyetli bir not ajanı ele geçiremez. Bir konuşmada gözlemlenen yeni gerçekler şu şekilde çıkarılır kanıtlı iddialar ve doğrudan belleğe yazılmak yerine inceleme için sıraya alındı.

İkinci bir yol daha vardır: ajan bir gerçeği kendisi memory_store aracıyla kaydedebilir. Bu yazmanın nasıl sonuçlanacağına çekirdek bellek yakalama modu karar verir — auto (varsayılan) iken gerçek hemen aranabilir; review veya off iken onay bekleyen bir aday olur. Araç sonucu bir searchable_now alanı taşır; böylece ajan, az önce kaydettiği gerçeğin şimdiden hatırlanıp hatırlanamayacağını size dürüstçe söyleyebilir.

[!NOTE] Sistem dizinler ve önerir, ama asla sessizce belleği yeniden yazmaz. review modunda bir iddianın uzun süreli belleğe aktarılması kasıtlı, insan tarafından incelenen bir adımdır; auto modunda (varsayılan) ajanın açıkça kaydettiği gerçekler anında aranabilir. Bellek modu (auto / review / off) ve geri getirme modu (fulltext / embedding), çekirdek ayarlarıdır (ayarlar kataloğunda AIHUMMER_MEMORY_CAPTURE / AIHUMMER_MEMORY_RETRIEVAL), bir eklenti formu değildir.

v2 bellek platformu (varsayılan olarak açık)

Einstein tümünü gönderir v2 bellek platformu, ve tüm gücü kutudan çıktığı gibi — elle bağlanacak bir şey yok: iddia çıkarımı, bir inceleme kuyruğu, bir arka plan türetici (kanıtlardan gerçekler, bağlantılar ve varlıklar), bir “rüya”/konsolidasyon geçişi (çoğaltmayı kaldırma ve bellek kendi kendini iyileştirme), bir bellek grafiği ve çelişki tespiti. Bellek modu, yerleştirici ve vektör deposu ayrıca, çekirdek ayarları olarak yapılandırılır. Einstein’ın kendisi satıcı tarafından yapılandırılır: eklenti hiçbir operatör ayarı sunmaz ve Eklentiler sayfasında yalnızca güncelleme eylemi kullanılabilir.

[!NOTE] Tek insan adımı canonical belleğe yazmayı onaylama (MEMORY.md). Her v2 işçisi yalnızca ayrı bir yan araç deposuna yazar ve asla dokunmaz kanonik Markdown. Einstein, kanona dahil edilmeye değer bir düzenleme yaptığında, inceleme kullanıcı arayüzünde gösterilir ve tek tıkla uygulanır. Yani tüm güç hemen kullanılabilir, ancak çekirdek garanti geçerlidir: bellek asla sizin haberiniz olmadan yeniden yazılmaz. Bu bir ürün kararıdır, operatör ayarı değildir.

Kurulum

Einstein bir yerleşik eklenti: her kiracı için otomatik olarak kurulur, taşır Yerleşik eklenti listesinde rozet ve kaldırılamaz — hafıza ürünün temelinin bir parçasıdır. Modülün kendisi her zaman mevcuttur, ancak bellek toplama kapatılabilir: off bellek modu (çekirdek AIHUMMER_MEMORY_CAPTURE ayarı), modülü kaldırmadan yeni hafızaların toplanmasını durdurur. Ayrı olarak kurulacak bir şey yoktur; normal eklentilerin tüm yaşam döngüsü şurada açıklanmıştır Kurulum ve güncellemeler. Konteyner yok — Einstein, ağ geçidi ile birlikte kendi systemd servisi olarak çalışır.

Güvenlik ve sınırlar

  • Kanonik Markdown okunabilir bir projeksiyondur. Sistem deposu PostgreSQL; indeksler ve yerleştirmeler türetilebilir; kanonik metin bir şeyin ne olduğudur insan incelemeleri ve düzenlemeleri.
  • Sessiz yeniden yazımlar yok. V2 platformu kutudan çıktığı gibi çalışır, ancak kanona yapılan bir yazma tek tıklamalı insan onayından geçer; işçiler yalnızca yan arabaya yazar ve asla kanonik Markdown’a dokunmaz.
  • Veri korumalı geri çağırma. Bellek, modele asla sınırlandırılmış araç çıktısı olarak ulaşmaz talimatlar olarak, dolaylı komut enjeksiyonunu engeller.
  • Güvenli Web Kullanıcı Arayüzü. Eklentinin inceleme/yönetim kullanıcı arayüzü erişim kontrollüdür.
  • Ana bilgisayar-dahil Container içinde değil, systemd altında çalışır.

Sonra nereye?