similarity-search-patterns
Ajuda seu agente a encontrar itens semelhantes em grandes conjuntos de dados. É útil para criar buscas por similaridade ou encontrar os vizinhos mais próximos de um item.
O que ela faz
Essa ferramenta ajuda a encontrar informações parecidas em grandes quantidades de dados, como se estivesse procurando por "coisas semelhantes" em um catálogo gigante. Ela usa técnicas avançadas para fazer isso de forma rápida e eficiente.
Quando usar
- ✓Quando você quer criar um sistema de busca que entende o significado do que você procura.
- ✓Ao construir um sistema que responde perguntas com base em documentos.
- ✓Para fazer recomendações personalizadas de produtos ou conteúdos.
Exemplo do que pedir para a IA
“Encontre documentos parecidos com este texto sobre culinária vegana.”
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
Por dentro, ela transforma seus dados em números (vetores) e usa métodos matemáticos para calcular quais números são mais próximos uns dos outros. Ela organiza esses números em índices especiais para que a busca seja muito rápida.
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 wshobson/agents --skill similarity-search-patternsOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/wshobson/agents/main/plugins/llm-application-dev/skills/similarity-search-patterns/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.
Padrões de Busca por Similaridade
Padrões para implementar busca por similaridade eficiente em sistemas de produção.
Quando Usar Esta Habilidade
- Construindo sistemas de busca semântica
- Implementando recuperação RAG
- Criando motores de recomendação
- Otimizando a latência de busca
- Escalando para milhões de vetores
- Combinando busca semântica e por palavras-chave
Conceitos Principais
1. Métricas de Distância
| Métrica | Fórmula | Ideal Para | | ------------------ | ------------------ | --------------------- | --- | -------------- | | Cosseno | 1 - (A·B)/(‖A‖‖B‖) | Embeddings normalizados | | Euclidiana (L2) | √Σ(a-b)² | Embeddings brutos | | Produto Escalar | A·B | Magnitude importa | | Manhattan (L1) | Σ | a-b | | Vetores esparsos |
2. Tipos de Índice
┌─────────────────────────────────────────────────┐
│ Index Types │
├─────────────┬───────────────┬───────────────────┤
│ Flat │ HNSW │ IVF+PQ │
│ (Exact) │ (Graph-based) │ (Quantized) │
├─────────────┼───────────────┼───────────────────┤
│ O(n) search │ O(log n) │ O(√n) │
│ 100% recall │ ~95-99% │ ~90-95% │
│ Small data │ Medium-Large │ Very Large │
└─────────────┴───────────────┴───────────────────┘
Modelos e exemplos detalhados
A biblioteca completa de modelos e exemplos detalhados está em references/details.md. Leia este arquivo quando precisar dos modelos concretos.
Melhores Práticas
O Que Fazer
- Use o índice apropriado - HNSW para a maioria dos casos
- Ajuste os parâmetros - ef_search, nprobe para recall/velocidade
- Implemente busca híbrida - Combine com busca por palavras-chave
- Monitore o recall - Meça a qualidade da busca
- Pré-filtre quando possível - Reduza o espaço de busca
O Que Não Fazer
- Não pule a avaliação - Meça antes de otimizar
- Não crie índices em excesso - Comece com flat, escale gradualmente
- Não ignore a latência - P99 importa para a experiência do usuário
- Não se esqueça dos custos - O armazenamento de vetores soma
Perguntas frequentes
O que são 'métricas de distância'?
São fórmulas matemáticas que medem o quão 'longe' ou 'perto' dois conjuntos de números (vetores) estão um do outro. Isso ajuda a encontrar informações semelhantes.
O que são 'tipos de índice'?
São diferentes formas de organizar os dados numéricos para que a busca seja mais rápida. Alguns são mais precisos, outros mais rápidos, e cada um é bom para um tamanho diferente de dados.
O que é 'busca híbrida'?
É combinar a busca por significado (semântica) com a busca por palavras-chave exatas. Assim, você encontra resultados que são tanto relevantes em significado quanto contêm as palavras que você digitou.
Detalhes
Descrição original do autor
Implement efficient similarity search with vector databases. Use when building semantic search, implementing nearest neighbor queries, or optimizing retrieval performance.
repo: wshobson/agents
Popularidade
- Estrelas no GitHub
- 41 mil
- Posição no ranking
- #4893
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
screen-reader-testing
Faz seu agente testar sites usando leitores de tela para garantir que sejam acessíveis.
wshobson/agents
wcag-audit-patterns
Ajuda seu agente a auditar sites para acessibilidade e corrigir problemas de acordo com as diretrizes WCAG.
wshobson/agents
multi-reviewer-patterns
Faz seu agente coordenar revisões de código paralelas, deduplicando achados e consolidando relatórios.
wshobson/agents
parallel-debugging
Permite ao agente depurar problemas complexos com investigações paralelas e análise de causa raiz.
wshobson/agents
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