Pular para o conteúdo
Skillpedia
Machine learning41 mil · #4893

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

https://github.com/wshobson/agents/blob/main/plugins/llm-application-dev/skills/similarity-search-patterns/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/wshobson/agents/blob/main/plugins/llm-application-dev/skills/similarity-search-patterns/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
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-patterns

Ou 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.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.

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

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas