qdrant-search-quality

Diagnose and improve Qdrant vector search relevance through routing to targeted remediation guides.

3|1|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/PALabs-v1/AI_friend --skill qdrant-search-quality-palabs-v1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qdrant-search-quality
Source: https://github.com/PALabs-v1/AI_friend/tree/main/.claude/skills/qdrant-search-quality
Command: npx skills add https://github.com/PALabs-v1/AI_friend --skill qdrant-search-quality-palabs-v1

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires qdrant-relevance-feedback.

What problem does it solve? Vector search results are often irrelevant, incomplete, or degraded after model changes, and engineers struggle to identify whether the embedding model, the data, or Qdrant's configuration is at fault. ## Core Features & Use Cases - Symptom-Based Diagnosis: Routes reports of bad results, low recall, or low precision to targeted diagnostic guidance using exact-vs-approximate search comparison. - Search Strategy Selection: Covers hybrid search with sparse and dense vectors, fusion methods (RRF, DBSF, FormulaQuery), reranking, MMR diversity, and relevance feedback. - Retrieval Measurement: Guides building golden sets and scoring recall@k, MRR, and NDCG to gate releases on retrieval quality. - Use Case: A team notices their RAG chatbot returns irrelevant documents after switching embedding models. Use this Skill to isolate the cause, compare exact versus approximate search, and select the right fix such as hybrid search or reranking. ## Quick Start Ask the assistant to diagnose why your Qdrant search results are irrelevant and recommend how to improve recall and precision.

Frequently Asked Questions about qdrant-search-quality

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix bad search results in Qdrant?

Start by comparing exact search against approximate HNSW search to isolate the cause. If exact search is also bad, the embedding model or data chunking is at fault; if only approximate search is bad, tune hnsw_ef, ef_construct, and m parameters.

How to combine keyword and vector search in Qdrant?

Use hybrid search with the Query API prefetch mechanism, running a sparse vector search (BM25 or SPLADE) alongside dense vector search in parallel. Fuse the results with RRF as a baseline, or DBSF when score distributions need normalization.

RRF vs DBSF for hybrid search fusion?

RRF is rank-based and ignores score magnitudes, making it a solid default when scores are on incomparable scales like BM25 and cosine. DBSF normalizes score distributions per prefetch using mean and standard deviation before fusing, but its absolute scores are not comparable across queries.

Does Qdrant quantization reduce search quality?

Yes, especially binary quantization without rescoring, which causes severe quality loss. Enable oversampling (3-5x minimum for binary) with rescoring, and always measure recall impact on your own data before deploying quantization to production.

How do I measure retrieval quality in Qdrant?

Build a labeled golden set of queries with known relevant documents, then score retrieval with metrics like recall@k for RAG, MRR for single-answer search, or NDCG for ranking. Use the ranx library and gate CI on metric thresholds to catch regressions.

When should I use relevance feedback instead of reranking?

Use Qdrant's Relevance Feedback API when the dense retriever misses relevant items outside the initial ANN pool or when reranking a large candidate set is too costly. It requires calibrating formula weights on 50-200 representative queries with a consistent feedback model.