Saltar al contenido

Integraciones

NativeMemoryProvider

Construya una vista de contexto limitada sobre un historial íntegro.

Core, Recall y Wiki

El provider nativo usa PostgreSQL y pgvector directamente. Core mantiene bloques fijados; Recall proyecta turnos recientes con paginación de mensajes grandes; Wiki recupera fragmentos de documentos. El contexto del turno es una proyección limitada mientras la base conserva contenido y revisiones.

pip install "orkmind[memory-provider]"
python -m orkmind.memory_provider.mcp

APIs y autorización

assemble_turn_context reúne las capas. search_history exige sesión o usuario; search_wiki y get_document comparten el filtro de alcance. set_core_block es una API de operador y no debe exponerse como herramienta del agente. La ausencia de personas e invariantes obligatorios produce un error.

Historial e ingestión

La base protege historial y revisiones mediante triggers append-only. La ingestión normaliza contenido para deduplicar, prepara chunks y embeddings y guarda el documento en una transacción. Se rechazan cambios incompatibles de dimensión vectorial o idioma de búsqueda. Los chunks son derivados y pueden reconstruirse; el documento íntegro sigue siendo la fuente.

Escritura en nombre de una persona

La ingesta de sistema no tiene dueño. Cuando la escritura viene de una persona, pase su alcance como writer: solo se graba lo que esa persona podría leer. Una clasificación fuera de alcance lanza ClassificationOutOfReachError antes de fragmentar o generar embeddings; el slug de un documento que no puede leer lanza SlugUnavailableError, sin revelar nada del documento que lo ocupa. Ambos rechazos heredan de WriteOutOfScopeError.

La deduplicación por contenido solo considera lo que el alcance permite ver, y cada actualización crea una revisión nueva registrada en ingested_by. suggest_documents completa [[link]] solo con lo que el alcance ve.

alcance = MemoryScopeFilter.for_user(user_context)
await memory.ingest_document(pedido, writer=alcance)