qdrant-vector-search

Guides Qdrant collection design, HNSW tuning, and filtered search within fusion retrieval pipelines.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Vector search quality degrades silently when payload filters are unindexed, HNSW parameters are mistuned, or a vector store is fused with other retrieval sources without explicit score normalization. This Skill provides concrete Qdrant patterns and fusion-pipeline reasoning to prevent recall, latency, and staleness bugs in memory/retrieval systems. ## Core Features & Use Cases - Collection and Payload Design: Guidance on storing filterable metadata in payloads with create_payload_index, and using named vectors for hybrid dense+sparse search in one collection. - HNSW and Quantization Tuning: Explains m, ef_construct, and query-time ef tradeoffs, plus when to use Qdrant's built-in scalar, binary, or product quantization instead of custom compression. - Fusion Pipeline Integration: Patterns for slotting Qdrant as one leg of a multi-source retrieval system (cache, vector, graph, relational, rerank), including cache invalidation strategy and dual-backend (Postgres/SQLite) test discipline. - Use Case: When modifying a memory store's vector search leg, use this Skill to decide whether a filter belongs in the payload index, whether to raise per-query ef for recall, and how to isolate which retrieval leg caused a quality regression. ## Quick Start Ask the AI to review the vector search code in your memory store and recommend Qdrant indexing, filtering, and fusion-weight improvements.

Frequently Asked Questions about qdrant-vector-search

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

FAQPage Schema
How do I filter Qdrant vector search results by metadata?

Use a must/should/must_not filter combined with the vector query, storing the filtered fields in the point payload. Call create_payload_index on frequently filtered fields, since unindexed payload filters degrade to a linear scan over candidates.

How do I tune HNSW parameters in Qdrant for better recall?

Raise the query-time ef parameter (hnsw_ef in some clients) for queries where recall matters more than latency, without rebuilding the index. The m and ef_construct parameters trade build time and memory against recall at index construction.

Does Qdrant support quantization to reduce memory usage?

Qdrant ships built-in scalar, binary, and product quantization. Scalar int8 quantization is the safe default recall/memory tradeoff; binary quantization is more aggressive and suits embedding models designed to tolerate it. Re-measure recall@K after enabling it.

How do I combine dense and sparse vector search in Qdrant?

Use named vectors to store multiple vector fields per point, such as a dense embedding plus a sparse keyword vector, in one collection. Qdrant's native multi-vector query then combines both scores server-side.

Why does my fusion retrieval pipeline return stale results?

A cache in front of the fusion pipeline without an invalidation strategy serves stale fused results indefinitely. Decide up front whether the cache is TTL-based, invalidated on write, or eventually consistent, and test that decision explicitly.

Why do tests pass on SQLite but fail on Postgres in a dual-backend system?

Each backend needs its own SQL dialect branch, and a test suite exercising only SQLite can pass while the Postgres branch drifts. Force the other backend in tests via a real connection object rather than overriding a read-only backend property.