Search & Retrieval

MemoryKit search returns ranked results using hybrid retrieval that combines vector similarity, full-text search, and reranking in a single call.

Hybrid search

Combines vector similarity and full-text search with automatic reranking for the best results.

const results = await mk.memories.search({
  query: "quarterly revenue targets",
  limit: 10,
  tags: "finance",
  precision: "high",
});
 
for (const hit of results.results) {
  console.log(`[${hit.score.toFixed(2)}] ${hit.title}`);
}

Query parameters

Use query parameters to narrow results by tags, type, date range, and precision.

User-scoped search

Pass userId to only retrieve memories belonging to that user. This is essential for multi-tenant apps where each user has their own knowledge base.

// Only retrieves memories created with userId: "user_123"
const results = await mk.memories.search({
  query: "What are my preferences?",
  userId: "user_123",
});

Common patterns