AiHummer
Deutsch
AnmeldenKonto
v1.0.x
{ }Swagger

Einstein (Speicher-Plugin)

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

Einstein ist das offizielle Langzeitspeicher-Plugin für AiHummer. Es gibt einem Agenten ein dauerhaftes, durchsuchbares Gedächtnis, das Neustarts und Gespräche überdauert, ohne dieses Gedächtnis jemals in eine Blackbox zu verwandeln. Die Leitregel ist einfach: PostgreSQL ist der Systemspeicher und kanonisches Markdown ist seine für Menschen lesbare Projektion, und das System indiziert und schlägt Änderungen vor. Im Modus review wird jede Beförderung ins Langzeitgedächtnis von einem Menschen überprüft; im Modus auto (dem Standard) wird ein Fakt, den der Agent explizit mit dem Werkzeug memory_store speichert, sofort auffindbar.

Das Plugin läuft host-nativ als eigener kleiner Python-Dienst (nur Standardbibliothek — kein schwergewichtiges Framework) und kommuniziert über das Gateway. aihummer.memory.v1 Vertrag. Das Speicher-Subsystem im Gateway (Ansprüche, Abruf, die Daten-Sperre) wird auf der Konzeptseite beschrieben Gedächtnis (Einstein); diese Seite behandelt die Plugin das unterstützt es.

Fakten

Feld Wert
Version 1.0.0
Port 8820
Laufzeit Python (Standardbibliothek), host-nativ

Was es ist

Einstein speichert Erinnerungen als menschenlesbares Markdown — der kanonische Datensatz, den eine Person öffnen, lesen und bearbeiten kann. Auf diesem Datensatz baut es die Mechanik auf, die ein Agent zur Spielzeit benötigt:

  • Abruf — rufe den für das aktuelle Gespräch relevanten Speicher ab.
  • Suche — Volltext- und embeddingsbasierte Suche über gespeicherte Fakten.
  • Eingebettete Darstellungen — Vektoren für semantisches Abrufen, über HTTP bereitgestellt.

Da das Markdown kanonal ist, ist an den Indizes nichts wertvoll: Sie können jederzeit aus diesem kanonischen Datensatz wiederhergestellt werden, und ein Prüfer liest immer denselben Text, den der Agent liest.

Wie es verwendet wird

Zur Drehzeit fragt das Gateway Einstein nach dem für den aktuellen Kontext relevanten Gedächtnis. Das Abrufen wird dem Modell geliefert. als ein Werkzeugergebnis, das in einem Datenzaun eingewickelt ist, niemals als eingeschleuste Anweisungen – sodass eine bösartige Notiz, die ihren Weg in den Speicher gefunden hat, den Agenten nicht übernehmen kann. Neue Fakten, die in einem Gespräch beobachtet werden, werden extrahiert als Behauptungen mit Beweisen und zur Überprüfung in die Warteschlange gestellt, anstatt direkt in den Speicher geschrieben zu werden.

Es gibt einen zweiten Weg: Ein Agent kann einen Fakt selbst mit dem Werkzeug memory_store speichern. Wie dieser Schreibvorgang landet, entscheidet der Erfassungsmodus des Kern-Gedächtnisses — mit auto (dem Standard) ist der Fakt sofort auffindbar; mit review oder off wird er zum Kandidaten, der auf Freigabe wartet. Das Werkzeugergebnis trägt ein Feld searchable_now, sodass der Agent Ihnen ehrlich sagen kann, ob der gerade gespeicherte Fakt bereits abgerufen werden kann.

[!NOTE] Das System indiziert und schlägt vor, schreibt aber niemals stillschweigend den Speicher um. Im Modus review ist die Beförderung einer Behauptung ins Langzeitgedächtnis ein bewusster, von Menschen überprüfter Schritt; im Modus auto (dem Standard) sind explizit vom Agenten gespeicherte Fakten sofort auffindbar. Speichermodus (automatisch / Überprüfung / aus) und Abrufmodus (Volltext / Einbettungen) sind Kern-Einstellungen (AIHUMMER_MEMORY_CAPTURE / AIHUMMER_MEMORY_RETRIEVAL im Einstellungskatalog), kein Plugin-Formular.

Die v2 Speicherplattform (standardmäßig aktiviert)

Einstein liefert das Ganze v2 Speicherplattform, und all seine Kraft ist aus der Packung — nichts von Hand verdrahten: Anspruchsextraktion, eine Überprüfungswarteschlange, ein Hintergrundableiter (Fakten, Links und Entitäten aus Beweisen), ein „Traum“/Konsolidierungslauf (Duplikate entfernen und Gedächtnis selbst reparieren), ein Gedächtnisgraph und Widerspruchserkennung. Speichermodus, Embedder und Vektorspeicher werden separat konfiguriert, als Kern-Einstellungen. Einstein selbst wird vom Anbieter konfiguriert: Das Plugin stellt keine Betreiber-Einstellungen bereit, und auf der Plugins-Seite ist nur seine Aktualisierungsaktion verfügbar.

[!NOTE] Der einzige menschliche Schritt ist Genehmigung eines Schreibens in den kanonischen Speicher (MEMORY.md). Jeder v2-Arbeiter schreibt nur in einen separaten Sidecar-Speicher und berührt niemals die kanonisches Markdown. Wenn Einstein eine Bearbeitung ableitet, die es wert ist, ins Kanon aufgenommen zu werden, es wird in der Überprüfungs-Benutzeroberfläche angezeigt und mit einem Klick angewendet. So steht die gesamte Leistung sofort zur Verfügung, und dennoch gilt die Kern-Garantie: Erinnerungen werden dir nie hinter deinem Rücken überschrieben. Das ist eine Produktentscheidung, keine Betreiber-Einstellung.

Installation

Einstein ist ein eingebautes Plugin: es installiert sich automatisch für jeden Mandanten, trägt eine Eingebaut Abzeichen in der Plugin-Liste und kann nicht entfernt werden — Erinnerung ist Teil des Produktkerns. Das Modul selbst ist immer vorhanden, aber Die Speicherverwaltung kann ausgeschaltet werden: der off Speichermodus (die Kern-Einstellung AIHUMMER_MEMORY_CAPTURE) verhindert, dass neue Erinnerungen gesammelt werden, ohne das Modul zu entfernen. Es gibt nichts separat zu installieren; der vollständige Lebenszyklus regulärer Plugins wird beschrieben in Installation & Updates. Es gibt keine Container — Einstein läuft als eigener systemd-Dienst neben dem Gateway.

Sicherheit und Grenzen

  • Kanonisches Markdown ist eine lesbare Projektion. Der Systemspeicher ist PostgreSQL; Indizes und Einbettungen sind ableitbar; der kanonische Text ist, was ein menschliche Überprüfungen und Bearbeitungen.
  • Keine stillen Umschreibungen. Die v2-Plattform funktioniert sofort, aber ein Schreibvorgang an Canon durchläuft die Ein-Klick-Menschliche Genehmigung; Arbeiter schreiben nur zur Seitenkarosse und berühren die kanonische Markdown niemals.
  • Datengefilterter Abruf. Speicher erreicht das Modell als abgegrenzte Werkzeugausgabe, niemals als Anweisungen, die indirekte Aufforderungsinjektionen blockieren.
  • Gesicherte Web-Benutzeroberfläche. Die Prüfungs-/Verwaltungsoberfläche des Plugins ist zugangskontrolliert.
  • Host-nativ. Läuft unter systemd, nicht in einem Container.

Wohin als Nächstes