Skip to content

Learn

Learn

This section explains how SurrealDB Agent Memory works. The mental model comes first, then each step a fact goes through, from ingest to retrieval, and last the architecture underneath. If context windows and embeddings are new to you, start with How an AI model remembers.

Agent Memory stores two kinds of material in one SurrealDB graph, the Authoritative and Experiential pillars from Eight pillars and six categories:

  • Authoritative - manuals, policies, product data, structured uploads (source.kind = "document", higher default trust).

  • Experiential - conversation, sessions, and derived facts (source.kind = "turn", reflections, elaborations, consolidations).

The sections below are organised by what you do with them: ingest, retrieve, reason and tune.

Authoritative

Experiential

Unified read path over facts and document passages:

HTTP tables: REST API and Surface, models, and security.

How writes are extracted, reconciled, and time-stamped - for both documents and turns:

Was this page helpful?

Last updated