Skip to main content

Global Settings

These settings control how Atlas stores, scores, and retains memories across your entire namespace.

Scoring weights

The hybrid scoring function S = α·V + β·R + γ·F + δ·A uses these defaults:
ParameterDefaultDescription
alpha (V)0.20Semantic similarity weight
beta (R)0.70Recency weight — dominant signal
gamma (F)0.10Access frequency weight
delta (A)0.50Graph relation alignment weight
Override per-request by passing scoring_weights in your retrieve payload:
{
  "query": "What changed last week?",
  "user_id": "user-123",
  "scoring_weights": {
    "alpha": 0.15,
    "beta": 0.85,
    "gamma": 0.05,
    "delta": 0.30
  }
}
Increase beta (recency) for agents that track fast-changing state (e.g. project management, support tickets). Increase alpha for agents doing document retrieval where recency matters less.

Semantic floor filter

Facts with semantic similarity below this threshold are dropped before scoring. Prevents noise from unrelated graph traversal. Default: V_min = 0.22 Lower it to surface more results. Raise it to tighten precision.

Memory consolidation schedule

Consolidation runs Ebbinghaus decay, prunes weak memories, and compresses semantically similar clusters via LLM.
POST /brain/consolidate
{
  "user_id": "user-123",
  "force": false
}
ParameterDefaultDescription
forcefalseRun even if consolidation ran recently
decay_rate0.85Confidence multiplier per consolidation cycle
prune_threshold0.15Delete facts below this confidence
compress_cluster_size5Min cluster size for LLM compression

Retrieval defaults

{
  "k": 5,
  "include_episodic": true,
  "include_semantic": true,
  "max_hops": 2
}
Increase max_hops for complex relational queries (e.g. "Who depends on X?"). Set include_episodic: false for faster graph-only retrieval.

Rate limits by plan

PlanRequests/minOps/month
Free10 rpm1,000
Starter60 rpm50,000
Pro300 rpm500,000
Scale1,000 rpm5,000,000
Exceeding the monthly op limit returns HTTP 429 with "detail": "ops_limit_exceeded".