qdrant-search-strategies
Orienta seu agente a escolher a melhor forma de buscar informações no Qdrant. É útil para obter resultados mais relevantes e diversificados.
O que ela faz
Este guia ajuda a melhorar os resultados de busca quando a busca básica não está funcionando bem. Ele sugere estratégias avançadas para refinar como os resultados são encontrados e ordenados.
Quando usar
- ✓Quando a busca por palavras-chave exatas falha.
- ✓Quando os resultados corretos aparecem, mas na ordem errada.
- ✓Quando os resultados são muito parecidos e falta diversidade.
Exemplo do que pedir para a IA
“Como posso fazer a busca encontrar documentos que mencionam 'Qdrant' mesmo que a descrição não use essa palavra?”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
O guia sugere usar métodos mais inteligentes que a busca simples por palavras. Ele explica como combinar diferentes tipos de busca ou reordenar os resultados para que os mais importantes apareçam primeiro.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add github/awesome-copilot --skill qdrant-search-strategiesOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/qdrant-search-quality/search-strategies/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Como Melhorar Resultados de Busca com Estratégias Avançadas
Estas estratégias complementam a busca vetorial básica. Use-as após confirmar que o modelo de embedding se ajusta à tarefa e a configuração do HNSW está correta. Se a busca exata retornar resultados ruins, verifique primeiro a seleção do modelo de embedding (retriever). Se o usuário quiser usar um modelo de embedding mais fraco por ser pequeno, rápido e barato, use reclassificação (reranking) ou feedback de relevância para melhorar a qualidade da busca.
Correspondências de Palavras-Chave Óbvias Ausentes
Use quando: a busca vetorial pura perde resultados que contêm correspondências de palavras-chave óbvias. Terminologia de domínio não presente nos dados de treinamento do embedding, correspondência exata de palavras-chave crítica (nomes de marca, SKUs), acrônimos comuns. Pule quando: consultas puramente semânticas, todos os dados no conjunto de treinamento, orçamento de latência muito apertado.
- Densos + esparsos com
prefetche fusão Busca Híbrida - Prefira esparsos aprendidos (miniCOIL, SPLADE, GTE) em vez de BM25 bruto, se aplicável (quando o usuário precisa de correspondência inteligente de palavras-chave e modelos esparsos aprendidos conhecem o vocabulário do domínio)
- Para idiomas não ingleses, configure os parâmetros do BM25 esparso de acordo
- RRF: bom padrão, suporta ponderado (v1.17+) RRF
- DBSF com limites assimétricos (sparse_limit=250, dense_limit=100) pode superar o RRF para documentos técnicos DBSF
- A fusão também pode ser feita através de reclassificação
Documentos Certos Encontrados Mas na Ordem Errada
Use quando: bom recall, mas baixa precisão (documentos certos nos top-100, não nos top-10).
- Reclassificadores Cross-encoder via FastEmbed Reclassificadores
- Veja como usar Consultas Multi-estágio no Qdrant
- A reclassificação ColBERT e ColPali/ColQwen é especialmente precisa devido aos mecanismos de interação tardia, mas é pesada. É importante configurar e armazenar multivetores sem construir HNSW para eles para economizar recursos. Veja Representação Multivetorial
Documentos Certos Não Encontrados Mas Eles Existem
Use quando: a recuperação básica está implementada, mas o retriever perde itens relevantes que você sabe que existem no conjunto de dados. Funciona em qualquer dado que possa ser transformado em embedding (texto, imagens, etc.).
A Consulta de Feedback de Relevância (RF) usa as pontuações de um modelo de feedback em resultados recuperados para direcionar o retriever através do espaço vetorial completo em iterações subsequentes, como reclassificar toda a coleção através do retriever. Complementar à reclassificação: um reclassificador vê um subconjunto limitado, RF aproveita sinais de feedback em toda a coleção. Mesmo 3–5 pontuações de feedback são suficientes. Pode executar múltiplas iterações.
Um modelo de feedback é qualquer coisa que produza uma pontuação de relevância por documento: um bi-encoder, cross-encoder, modelo de interação tardia, LLM-como-juiz. Pontuações de relevância imprecisas funcionam, não apenas binárias (bom/ruim, relevante/irrelevante), devido ao fato de que o feedback é expresso como uma pontuação de relevância graduada (quanto maior = mais relevante).
Pule quando: se o retriever já tem um recall forte, ou se o retriever e o modelo de feedback concordam fortemente sobre a relevância.
- A Consulta RF é atualmente baseada em uma fórmula ingênua de 3 parâmetros sem padrões universais, portanto, deve ser ajustada por conjunto de dados, retriever e modelo de feedback
- Use qdrant-relevance-feedback para ajustar parâmetros, avaliar o impacto com o Evaluator e verificar a concordância entre retriever e feedback. Veja o README para instruções de configuração. Nenhuma GPU é necessária, e o framework também fornece opções predefinidas de retriever e modelo de feedback.
- Verifique a configuração da API de Consulta de Feedback de Relevância
…
Perguntas frequentes
O que é busca híbrida?
É uma combinação de busca por palavras-chave exatas (como BM25) com busca por similaridade de significado (vetores). Ajuda a encontrar resultados que usam sinônimos ou termos relacionados.
O que é 'reranking'?
É um processo que reordena os resultados já encontrados. Um modelo mais inteligente olha para os primeiros resultados e os organiza para que os mais relevantes fiquem no topo.
O que é MMR?
MMR (Maximal Marginal Relevance) é uma técnica para evitar que os resultados sejam muito repetidos. Ele busca um equilíbrio entre mostrar resultados relevantes e garantir que eles sejam diferentes uns dos outros.
Detalhes
Descrição original do autor
Guides Qdrant search strategy selection. Use when someone asks 'should I use hybrid search?', 'BM25 or sparse vectors?', 'how to rerank?', 'results are not relevant', 'I don't get needed results from my dataset but they're there', 'retrieval quality is not good enough', 'results too similar', 'need diversity', 'MMR', 'relevance feedback', 'recommendation API', 'discovery API', 'ColBERT reranking',
repo: github/awesome-copilot
Popularidade
- Estrelas no GitHub
- 40 mil
- Posição no ranking
- #5317
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
acquire-codebase-knowledge
Ajuda seu agente a entender e documentar um projeto de código existente. É útil para novas pessoas entrarem no projeto ou para ter uma visão geral da arquitetura.
github/awesome-copilot
acreadiness-assess
Faz seu agente avaliar a prontidão de um projeto para IA e gerar um relatório. É útil para entender o quão bem um projeto está preparado para usar ferramentas de IA.
github/awesome-copilot
acreadiness-generate-instructions
Ajuda seu agente a criar instruções para ferramentas de IA baseadas em uma avaliação. É útil para melhorar a forma como a IA interage com o código e fecha lacunas identificadas.
github/awesome-copilot
acreadiness-policy
Faz seu agente ajudar a definir ou aplicar políticas para avaliação de projetos de IA. É útil para padronizar a forma como os projetos são avaliados e garantir conformidade.
github/awesome-copilot
Skills parecidas
pytorch-patterns
Ajuda seu agente a usar o PyTorch para criar modelos de aprendizado de máquina. Ele aplica as melhores práticas para treinar modelos de forma eficiente e garantir que os resultados sejam consistentes.
affaan-m/ECC
evm-token-decimals
Ajuda seu agente a evitar erros com números decimais em diferentes redes blockchain. Garante que os valores de tokens sejam precisos em transações e cálculos.
affaan-m/ECC
knowledge-agent
Cria e consulta bases de conhecimento com inteligência artificial. Permite fazer perguntas sobre trabalhos passados ou compilar conhecimento sobre um tema.
thedotmack/claude-mem