Pular para o conteúdo
Skillpedia
Machine learning40 mil · #5317

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

https://github.com/github/awesome-copilot/blob/main/skills/qdrant-search-quality/search-strategies/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/github/awesome-copilot/blob/main/skills/qdrant-search-quality/search-strategies/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
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-strategies

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/qdrant-search-quality/search-strategies/SKILL.md -o SKILL.md
Conteú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 prefetch e 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

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas