​

Довідник із конфігурації пам’яті

• Огляд пам’яті — як працює пам’ять
• Вбудований рушій — типовий бекенд SQLite
• Рушій QMD — локальний sidecar
• Пошук у пам’яті — конвеєр пошуку та налаштування
• Active Memory — увімкнення субагента пам’яті для інтерактивних сесій

1. Plugin має бути ввімкнений і націлений на поточний id агента
2. запит має бути придатною інтерактивною сесією постійного чату

​

Вибір постачальника

​

Порядок автовизначення

1. local — якщо налаштовано memorySearch.local.modelPath і файл існує.
2. github-copilot — якщо можна визначити токен GitHub Copilot (змінна середовища або профіль автентифікації).
3. openai — якщо можна визначити ключ OpenAI.
4. gemini — якщо можна визначити ключ Gemini.
5. voyage — якщо можна визначити ключ Voyage.
6. mistral — якщо можна визначити ключ Mistral.
7. bedrock — якщо ланцюжок облікових даних AWS SDK успішно визначається (роль екземпляра, ключі доступу, профіль, SSO, web identity або спільна конфігурація).

​

Визначення API-ключа

​

Конфігурація віддаленої кінцевої точки

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

​

Конфігурація, специфічна для Gemini

​

Конфігурація ембедингів Bedrock

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

​

Підтримувані моделі

​

Автентифікація

1. Змінні середовища (AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY)
2. Кеш токенів SSO
3. Облікові дані токена web identity
4. Спільні файли облікових даних і конфігурації
5. Облікові дані метаданих ECS або EC2

​

Дозволи IAM

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

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

​

Локальна конфігурація ембедингів

​

Конфігурація гібридного пошуку

​

MMR (різноманітність)

​

Часове згасання (свіжість)

​

Повний приклад

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

​

Додаткові шляхи пам’яті

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

​

Мультимодальна пам’ять (Gemini)

​

Кеш ембедингів

​

Пакетна індексація

​

Пошук у пам’яті сесій (експериментально)

​

Прискорення векторів SQLite (sqlite-vec)

​

Сховище індексу

​

Конфігурація бекенда QMD

​

Розклад оновлень

​

Обмеження

​

Область дії

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

​

Цитати

​

Повний приклад 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

​

Налаштування користувача

​

Приклад

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

• Dreaming записує машинний стан у memory/.dreams/.
• Dreaming записує зрозумілий людині наративний вивід у DREAMS.md (або наявний dreams.md).
• Політика фаз light/deep/REM і пороги є внутрішньою поведінкою, а не користувацькою конфігурацією.