# Memory & knowledge

Ingest, retrieve, reason, and tune agent memory on SurrealDB Agent Memory's unified substrate.

SurrealDB Agent Memory stores **authoritative** and **experiential** material in **one** SurrealDB graph - the **Authoritative** and **Experiential** pillars from [Eight pillars and six categories](/docs/agent-memory/architecture/eight-pillars-and-categories.md). This section is organised by **what you do** (ingest, retrieve, reason, tune), not by two separate products.

- **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).

Start with [Unified substrate and authority](/docs/agent-memory/mental-model/two-layer-architecture.md) and [Memory categories](/docs/agent-memory/mental-model/memory-categories.md) (the six experiential types, including chat-extracted **knowledge** - distinct from authoritative uploads).

## Ingest

**Authoritative**

- [Uploading documents](/docs/agent-memory/ingest/authoritative/uploading-documents.md), [Bulk import](/docs/agent-memory/ingest/authoritative/bulk-import.md)
- [Multi-modal content](/docs/agent-memory/ingest/authoritative/multimodal-content.md), [Knowledge nodes](/docs/agent-memory/ingest/authoritative/knowledge-nodes.md)

**Experiential**

- [Remember](/docs/agent-memory/ingest/experiential/remember.md) - `POST /facts` and `/facts/batch`
- [Sessions](/docs/agent-memory/sessions/chat-sessions.md) - containers for turns ([creating](/docs/agent-memory/sessions/creating-sessions.md), [adding turns](/docs/agent-memory/sessions/adding-turns.md))

## Retrieve

Unified read path over facts **and** document passages:

- [Recalling memories](/docs/agent-memory/retrieve/recall.md) - `/query`, `/context`, `/chat`
- [Hybrid search](/docs/agent-memory/retrieve/hybrid-search.md), [Keywords and BM25](/docs/agent-memory/retrieve/keywords-and-bm25.md), [Graph traversal](/docs/agent-memory/retrieve/graph-traversal.md)

HTTP tables: [REST API](/docs/agent-memory/reference/rest-api.md) and [Surface, models, and security](/docs/agent-memory/architecture/surface-security-and-models.md).

## Reasoning

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

- [Extraction pipeline](/docs/agent-memory/reasoning/extraction-pipeline.md)
- [Reconciliation and supersession](/docs/agent-memory/reasoning/reconciliation-and-supersession.md)
- [Authority when pillars meet](/docs/agent-memory/reasoning/authority-hierarchy.md), [Cross-layer linking](/docs/agent-memory/reasoning/cross-layer-linking.md)
- [Temporal validity](/docs/agent-memory/reasoning/temporal-validity.md), [Instructions and uncertainties](/docs/agent-memory/reasoning/instructions-and-uncertainties.md)

## Operations & tuning

- [Reflect](/docs/agent-memory/operations/reflect.md), [Forget](/docs/agent-memory/operations/forget.md), [Profiles](/docs/agent-memory/operations/profiles.md)
- [Models per stage](/docs/agent-memory/tuning/models-per-stage.md), [Caching and invalidation](/docs/agent-memory/tuning/caching-and-invalidation.md), [Extraction vocabulary](/docs/agent-memory/tuning/ontology-grounding.md)