Einstein (complemento de memoria)
Einstein es el complemento oficial de memoria a largo plazo para AiHummer. Proporciona a un agente una memoria duradera y searchable que sobrevive a reinicios y conversaciones, sin convertir nunca esa memoria en una caja negra. La regla guía es simple: PostgreSQL es el almacén del sistema y Markdown canónico es su proyección legible por humanos, y el sistema indexa y propone cambios. En el modo review cada promoción a la memoria a largo plazo es revisada por un humano; en el modo auto (el predeterminado), un hecho que el agente guarda explícitamente con la herramienta memory_store se puede buscar de inmediato.
El complemento se ejecuta de manera nativa en el host como su propio pequeño servicio de Python (solo biblioteca estándar — sin marco pesado) y se comunica con la puerta de enlace a través de la aihummer.memory.v1 contrato. El subsistema de memoria de entrada (reclamaciones, recuperación, la valla de datos) se describe en la página de concepto Memoria (Einstein); esta página cubre la complemento que lo respalda.
Hechos
| Campo | Valor |
|---|---|
| Versión | 1.0.0 |
| Puerto | 8820 |
| Tiempo de ejecución | Python (biblioteca estándar), nativo del host |
Qué es
Einstein almacena la memoria como Markdown legible para humanos — el registro canónico que una persona puede abrir, leer y editar. Sobre ese registro construye la maquinaria que un agente necesita en el momento de su turno:
- Recuperación — busca la memoria relevante a la conversación actual.
- Buscar — búsqueda de texto completo y basada en incrustaciones sobre hechos almacenados.
- Incrustaciones — vectores para la recuperación semántica, servidos a través de HTTP.
Debido a que el Markdown es canónico, nada sobre los índices es precioso: pueden reconstruirse a partir de ese registro canónico en cualquier momento, y un revisor siempre lee el mismo texto que el agente lee.
Cómo se usa
En el momento de girar, la puerta de enlace le pide a Einstein la memoria relevante para el contexto actual. El recuerdo se entrega al modelo como un resultado de herramienta envuelto en una valla de datos, nunca como instrucciones inyectadas, por lo que una nota maliciosa que encontrara su camino en la memoria no puede secuestrar al agente. Los nuevos hechos observados en una conversación se extraen como afirmaciones con evidencia y puesto en cola para revisión en lugar de escrito directamente en la memoria.
Existe un segundo camino: un agente puede guardar un hecho por sí mismo con la herramienta memory_store. Cómo aterriza esa escritura lo decide el modo de captura de memoria del núcleo: con auto (el predeterminado) el hecho se puede buscar de inmediato; con review u off se convierte en un candidato pendiente de aprobación. El resultado de la herramienta lleva un campo searchable_now, de modo que el agente puede decirte honestamente si el hecho que acaba de guardar ya se puede recordar.
[!NOTE] El sistema indexa y propone, pero nunca reescribe la memoria silenciosamente. En el modo
review, la promoción de un reclamo a la memoria a largo plazo es un paso deliberado y revisado por humanos; en el modoauto(el predeterminado), los hechos que el agente guarda explícitamente se pueden buscar de inmediato. El modo de memoria (automático / repaso / apagado) y el modo de recuperación (texto completo / embeddings) son ajustes del núcleo (AIHUMMER_MEMORY_CAPTURE/AIHUMMER_MEMORY_RETRIEVALen el catálogo de ajustes), no un formulario del complemento.
La plataforma de memoria v2 (activada por defecto)
Einstein envía el completo plataforma de memoria v2, y todo su poder está fuera de la caja — nada que conectar manualmente: extracción de reclamaciones, una cola de revisión, un derivador en segundo plano (hechos, enlaces y entidades a partir de evidencia), una pasada de “sueño”/consolidación (eliminación de duplicados y auto-reparación de la memoria), un grafo de memoria y detección de contradicciones. El modo de memoria, el incrustador y el almacenamiento vectorial se configuran por separado, como ajustes del núcleo. El propio Einstein lo configura el proveedor: el complemento no expone ajustes de operador, y en la página de Complementos solo está disponible su acción de actualización.
[!NOTE] El único paso humano es aprobando una escritura en la memoria canónica (
MEMORY.md). Cada trabajador v2 escribe solo en una tienda sidecar separada y nunca toca la Markdown canónico. Cuando Einstein deriva una edición que vale la pena incorporar al canon, se muestra en la interfaz de revisión y se aplica con un clic. Así que toda la potencia está disponible de inmediato, y sin embargo la garantía central sigue vigente: La memoria nunca se reescribe a tus espaldas. Eso es una decisión de producto, no un ajuste de operador.
Instalación
Einstein es un plugin integrado: se instala automáticamente para cada inquilino, lleva un Incorporado insignia en la lista de complementos y no se puede eliminar — la memoria es parte del núcleo del producto. El módulo en sí siempre está presente, pero la recolección de memoria se puede desactivar: el off modo de memoria (el ajuste del núcleo AIHUMMER_MEMORY_CAPTURE) detiene la recopilación de nuevos recuerdos sin necesidad de quitar el módulo. No hay nada que instalar por separado; el ciclo de vida completo de los complementos regulares se describe en Instalar y actualizar. No hay contenedores: Einstein se ejecuta como su propio servicio systemd junto con la puerta de enlace.
Seguridad y límites
- El Markdown canónico es una proyección legible. La tienda del sistema es PostgreSQL; los índices y las incrustaciones son derivables; el texto canónico es lo que un revisiones y ediciones humanas.
- No hay reescrituras silenciosas. La plataforma v2 funciona desde el primer momento, pero una escritura a Canon pasa por la aprobación humana de un solo clic; los trabajadores escriben solo al sidecar y nunca tocan el Markdown canónico.
- Recuerdo protegido por datos. La memoria llega al modelo como salida de herramienta cercada, nunca como instrucciones, que bloquean la inyección de indicaciones indirectas.
- Interfaz web segura. La interfaz de revisión/gestión del complemento está controlada por acceso.
- Host-nativo. Se ejecuta bajo systemd, no en un contenedor.