multi-query

What problem does it solve?

Multi-query expansion improves search recall by generating multiple variants of a user query, querying each variant, and fusing results using Reciprocal Rank Fusion (RRF) to yield a unified, deduplicated result set.

Core Features & Use Cases

• Variant generation: heuristic keyword variants, OR variants, and exact phrase variants to widen recall without relying on large language models.
• Fusion strategy: combine results from all variants using Reciprocal Rank Fusion to boost chunks appearing across variants.
• Flexible deployment: supports heuristic mode by default and optional LLM-based expansion for semantic diversity, with per-query configuration and performance tuning.

Quick Start

Enable query expansion for a hybrid search to generate multiple variants and fuse results with RRF. Example: memory.search(owner_id='workspace-1', query_text='improve customer retention', search_type=SearchType.HYBRID, query_expansion=True, max_query_variants=3, limit=10).