Source: Memory (CrewAI docs)

CrewAI's unified Memory class: LanceDB storage, hierarchical scopes, LLM-assisted save and recall, defaults and limitations.

Contents

Summary

A single Memory class replaces the older short-term, long-term, entity and external memory types. Memories are stored in LanceDB in a path-like scope tree, saved with LLM-inferred scope and importance, and recalled by shallow vector search or a deeper multi-step recall flow.

Key claims

  • Default storage: LanceDB under ./.crewai/memory; custom backends via a StorageBackend protocol.
  • Default embedder: OpenAI text-embedding-3-large; changing embedding models can break existing stores.
  • Recall ranks by semantic similarity, recency (30-day half-life) and importance, weighted 0.5/0.3/0.2.
  • Deep recall (default) uses an LLM; queries under 200 characters skip LLM analysis.
  • Saves and deep recall send content to the configured LLM, a privacy consideration.
  • Background save failures are emitted as events, not raised, so they can go unnoticed.

Feeds

Suggest changes →