Overview

Search

Search provides powerful retrieval over your indexed sources using multiple search modes.

Search Modes

Mode	Algorithm	Best For
keyword	BM25	Exact term matching, technical queries
semantic	Vector similarity	Conceptual queries, synonyms
hybrid	RRF fusion	General queries (recommended)

Hybrid Search

Hybrid search combines keyword and semantic results using Reciprocal Rank Fusion (RRF):

1. Run BM25 keyword search
2. Run vector similarity search
3. Normalize and fuse rankings
4. Return merged results

Configuration

• Embeddings: Requires OpenAI API key for semantic/hybrid modes
• Model: Default text-embedding-3-small (1536 dimensions)
• Fallback: Auto-falls back to keyword if embeddings unavailable

Example Query

curl "http://localhost:8000/api/workspaces/{id}/search?q=latency+requirements&mode=hybrid&limit=10"