Memory konfigürasyonu

Moonborn'un memory katmanının üç tier'ı (kısa vadeli context, uzun vadeli pgvector retrieval, cold archive) ve bir opt-in escape hatch'i (cross-session memory) var. Dördü de config-driven.

Kısa vadeli pencere

chat.memory.short_term.window_turns (default 12). Son N tur in-prompt aynen biniyor. Daha yüksek = daha fazla hatırlama ama daha fazla maliyet ve daha yavaş inference.

await client.config.setItem({
  key: 'chat.memory.short_term.window_turns',
  value: 16,
  scope: 'workspace',
  scopeId: 'ws_...',
});

Uzun vadeli retrieval

Eski turlar özetlenir ve voyage-3-large ile embed edilir (default; engine.embedding.model ile konfigüre edilebilir). Her yeni tur top-K ilgili chunk'ı retrieve eder:

• chat.memory.long_term.top_k (default 4)
• chat.memory.long_term.retrieval_strategy (default hybrid — semantic + BM25 + rerank + MMR)

Uzun destek oturumları için top_k'yı 8'e çıkar. Tutarlılığın daha az önemli olduğu yaratıcı oyun için 2'ye düşür.

Cold tier

chat.memory.long_term.cold_tier_after_days'tan eski chunk'lar (default 90) daha yavaş storage'a taşınır ve default retrieval tarafından atlanır. Kullanıcı açıkça eski bir şeyi referans ederse hâlâ sorgulanabilir.

Cross-session memory (Team+)

Default'ta memory session-scope'lu — bir persona oturumlar arasında hatırlamaz. Cross-session devamlılığı etkinleştirmek için:

await client.config.setItem({
  key: 'chat.memory.cross_session.enabled',
  value: true,
  scope: 'workspace',
  scopeId: 'ws_...',
});

Bunun privacy implikasyonları var — bir persona şimdi oturumlar arasında bilgi taşır, muhtemelen kullanıcılar arası. Consent UI ve net bir retention policy ile eşle.

Manuel unutma

DELETE /v1/chat/sessions/{id}/memory/{chunk_id} bir memory chunk'ı kaldırır. Persona o spesifik gerçeği oturum için unutur.

İlgili

• Long-term memory concept.
• GET /v1/chat/sessions/{id}/memory reference.