​

Riferimento di configurazione della memoria

• Panoramica della memoria — come funziona la memoria
• Motore integrato — backend SQLite predefinito
• Motore QMD — sidecar locale-first
• Ricerca nella memoria — pipeline di ricerca e ottimizzazione
• Active Memory — abilitazione del sottoagente di memoria per sessioni interattive

1. il plugin deve essere abilitato e puntare all’ID agente corrente
2. la richiesta deve essere una sessione di chat interattiva persistente idonea

​

Selezione del provider

​

Ordine di rilevamento automatico

1. local — se memorySearch.local.modelPath è configurato e il file esiste.
2. github-copilot — se è possibile risolvere un token GitHub Copilot (variabile d’ambiente o profilo di autenticazione).
3. openai — se è possibile risolvere una chiave OpenAI.
4. gemini — se è possibile risolvere una chiave Gemini.
5. voyage — se è possibile risolvere una chiave Voyage.
6. mistral — se è possibile risolvere una chiave Mistral.
7. bedrock — se la catena di credenziali AWS SDK si risolve (ruolo istanza, chiavi di accesso, profilo, SSO, identità web o configurazione condivisa).

​

Risoluzione della chiave API

​

Configurazione dell’endpoint remoto

{
  agents: {
    defaults: {
      memorySearch: {
        provider: "openai",
        model: "text-embedding-3-small",
        remote: {
          baseUrl: "https://api.example.com/v1/",
          apiKey: "YOUR_KEY",
        },
      },
    },
  },
}

​

Configurazione specifica di Gemini

​

Configurazione degli embeddings Bedrock

{
  agents: {
    defaults: {
      memorySearch: {
        provider: "bedrock",
        model: "amazon.titan-embed-text-v2:0",
      },
    },
  },
}

​

Modelli supportati

​

Autenticazione

1. Variabili d’ambiente (AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY)
2. Cache del token SSO
3. Credenziali del token di identità web
4. File condivisi di credenziali e configurazione
5. Credenziali dei metadati ECS o EC2

​

Permessi IAM

{
  "Effect": "Allow",
  "Action": "bedrock:InvokeModel",
  "Resource": "*"
}

arn:aws:bedrock:*::foundation-model/amazon.titan-embed-text-v2:0

​

Configurazione degli embeddings locali

​

Configurazione della ricerca ibrida

​

MMR (diversità)

​

Decadimento temporale (recenza)

​

Esempio completo

{
  agents: {
    defaults: {
      memorySearch: {
        query: {
          hybrid: {
            vectorWeight: 0.7,
            textWeight: 0.3,
            mmr: { enabled: true, lambda: 0.7 },
            temporalDecay: { enabled: true, halfLifeDays: 30 },
          },
        },
      },
    },
  },
}

​

Percorsi di memoria aggiuntivi

{
  agents: {
    defaults: {
      memorySearch: {
        extraPaths: ["../team-docs", "/srv/shared-notes"],
      },
    },
  },
}

​

Memoria multimodale (Gemini)

​

Cache degli embeddings

​

Indicizzazione in batch

​

Ricerca nella memoria delle sessioni (sperimentale)

​

Accelerazione vettoriale SQLite (sqlite-vec)

​

Archiviazione dell’indice

​

Configurazione del backend QMD

​

Pianificazione degli aggiornamenti

​

Limiti

​

Ambito

{
  memory: {
    qmd: {
      scope: {
        default: "deny",
        rules: [{ action: "allow", match: { chatType: "direct" } }],
      },
    },
  },
}

​

Citazioni

​

Esempio completo QMD

{
  memory: {
    backend: "qmd",
    citations: "auto",
    qmd: {
      includeDefaultMemory: true,
      update: { interval: "5m", debounceMs: 15000 },
      limits: { maxResults: 6, timeoutMs: 4000 },
      scope: {
        default: "deny",
        rules: [{ action: "allow", match: { chatType: "direct" } }],
      },
      paths: [{ name: "docs", path: "~/notes", pattern: "**/*.md" }],
    },
  },
}

​

Dreaming

​

Impostazioni utente

​

Esempio

{
  plugins: {
    entries: {
      "memory-core": {
        config: {
          dreaming: {
            enabled: true,
            frequency: "0 3 * * *",
          },
        },
      },
    },
  },
}

• Dreaming scrive lo stato macchina in memory/.dreams/.
• Dreaming scrive output narrativo leggibile da esseri umani in DREAMS.md (o dreams.md esistente).
• La policy e le soglie delle fasi light/deep/REM sono comportamenti interni, non configurazione esposta all’utente.