qdrant-search-quality-diagnosis

Compare exact KNN ground truth with approximate HNSW results to measure Qdrant recall.

17|29|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/lucifertrj/skills-based-app --skill qdrant-search-quality-diagnosis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qdrant-search-quality-diagnosis
Source: https://github.com/lucifertrj/skills-based-app/tree/main/.agents/skills/qdrant-search-quality/diagnosis
Command: npx skills add https://github.com/lucifertrj/skills-based-app --skill qdrant-search-quality-diagnosis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses Qdrant search quality issues in production by identifying causes of irrelevant or missing results and guiding corrective actions.

Core Features & Use Cases

  • Baseline and ground-truth comparison: evaluate recall by contrasting exact KNN results with approximate HNSW results.
  • Troubleshooting workflows: isolate issues related to quantization, payload filtering, and filtered search behavior.
  • Guided parameter tuning: provide actionable steps for adjusting hnsw_ef, ef_construct, and m, with references to best practices.
  • Use Case: When users report poor relevance or recall drops after deployment.

Quick Start

Run a baseline comparison of exact KNN results versus HNSW results on production queries to measure recall.

Frequently Asked Questions about qdrant-search-quality-diagnosis

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

FAQPage Schema
How do I diagnose Qdrant search quality issues when relevant results are missing?

Diagnose Qdrant search quality by comparing exact KNN ground truth with approximate HNSW results to measure recall. This baseline comparison isolates whether missing matches stem from quantization, payload filtering, or HNSW parameter misconfiguration.

Why does recall degrade in Qdrant after enabling quantization or payload filtering?

Recall degrades because quantization compresses vector precision and payload filtering narrows the HNSW graph traversal path. Diagnose this by contrasting exact KNN results with filtered or quantized HNSW outputs to identify the specific recall drop.

How do I tune HNSW parameters like hnsw_ef, ef_construct, and m to improve vector search recall?

Tune HNSW parameters by establishing a baseline recall score and iteratively adjusting hnsw_ef for search, and ef_construct with m for indexing. Validate each parameter change against exact KNN ground truth to ensure recall improvements.

What is the best way to validate Qdrant search relevance fixes in a production pipeline?

Validate Qdrant search relevance fixes by establishing exact KNN baselines and running reproducible tests against HNSW results. This ensures that parameter tuning and filtering adjustments yield measurable recall improvements before production deployment.

Can I use exact KNN search to establish a ground truth baseline for Qdrant HNSW recall evaluation?

Yes, you can use exact KNN search to establish a ground truth baseline for Qdrant HNSW recall evaluation. Comparing exact KNN results against approximate HNSW outputs provides the definitive recall metric needed to guide parameter tuning.

What are the limitations of using HNSW approximate search compared to exact KNN in Qdrant?

HNSW approximate search trades exact recall for speed, meaning results may miss true nearest neighbors compared to exact KNN. Limitations become pronounced with aggressive quantization or strict payload filtering, requiring careful hnsw_ef tuning to maintain acceptable recall.