How it works
Semantic search excels at understanding meaning but can miss specific terms, product names, and exact phrases. Keyword search (BM25) excels at matching specific terms but misses paraphrased content. Hybrid search combines both:
- Semantic search: Finds content with similar meaning to the query
- BM25 keyword search: Finds content containing the exact terms
- Reciprocal Rank Fusion (RRF): Merges and re-ranks both result sets
This means searching for "Chatsy Pro plan pricing" would find documents about "Chatsy Pro subscription cost" (semantic) AND documents containing the exact term "Pro plan" (keyword). Neither search alone would find both.
Why it matters
For AI chatbots, retrieval accuracy directly determines answer quality. If the search step misses relevant content, the AI cannot generate a correct answer, no matter how good the language model is. Hybrid search is the current best practice for RAG systems because it maximizes recall without sacrificing precision.
How Chatsy uses it
Chatsy uses hybrid search as its core retrieval engine. Customer questions are searched against the knowledge base using both pgvector semantic search and PostgreSQL full-text search (BM25). Results are merged using Reciprocal Rank Fusion to provide the most relevant passages to the AI for answer generation.
Chatsy
What else should I know about Hybrid Search?
Reciprocal Rank Fusion (RRF) merges and re-ranks results from both search methods
Key takeawaysTest this in your own agent
Add your help content, ask the questions on this page, and check every answer before you publish.
Start freeChatsy
Example scenarios
- 01
Product name + intent matching
A customer asks "how do I set up Chatsy Pro webhooks?" Keyword search finds documents containing "Chatsy Pro" and "webhooks" (exact terms). Semantic search finds documents about "configuring event notifications" (meaning). Hybrid search returns both, ensuring the most relevant result ranks first.
- 02
Technical jargon handling
A developer asks about "CORS errors on the REST API." Keyword search catches the exact technical terms (CORS, REST API). Semantic search also finds related articles about "cross-origin request configuration" and "API access control." The combined results cover both exact and related content.
- 03
Misspelled query recovery
A customer types "refud polcy" (misspelled). Keyword search fails because no documents contain those misspellings. Semantic search still matches the query to the "Refund Policy" article because the embedding captures meaning despite typos. Hybrid search recovers from the keyword failure.
Key takeaways
- Hybrid search combines semantic vector search with BM25 keyword search for maximum accuracy
- Reciprocal Rank Fusion (RRF) merges and re-ranks results from both search methods
- Test recall on your own questions: the gain over vector search alone depends on your content
- Keyword search catches exact terms and product names that semantic search can miss
- The additional latency is negligible (10-50ms) because both searches run in parallel
When it does not apply
- You have very small content corpora where pure keyword search already covers the cases.
- Your latency requirements demand a single index round-trip with no merge step.