embedding-strategies
Ajuda seu agente a escolher os melhores modelos para busca semântica. Melhora a forma como ele entende e encontra informações.
O que ela faz
Esta ferramenta ajuda você a escolher o melhor modelo para transformar textos em números (vetores) para que computadores entendam o significado. Ela também dá dicas de como organizar esses textos para que a busca seja mais eficiente.
Quando usar
- ✓Quando você precisa escolher um modelo para que a IA entenda seus textos.
- ✓Ao decidir como dividir seus textos em pedaços para a IA processar.
- ✓Se quiser melhorar a qualidade das informações que a IA extrai dos seus textos.
Exemplo do que pedir para a IA
“Qual o melhor modelo de embedding para buscar informações em documentos financeiros?”
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
A ferramenta compara diferentes modelos de 'embedding', que são como tradutores de texto para números. Ela também mostra um processo para preparar o texto antes de transformá-lo em números, garantindo que a IA entenda melhor.
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 embedding-strategiesOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/wshobson/agents/main/plugins/llm-application-dev/skills/embedding-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.
Estratégias de Embedding
Guia para selecionar e otimizar modelos de embedding para aplicações de busca vetorial.
Quando Usar Esta Habilidade
- Escolhendo modelos de embedding para RAG
- Otimizando estratégias de chunking (divisão em pedaços)
- Ajustando embeddings para domínios específicos
- Comparando o desempenho de modelos de embedding
- Reduzindo dimensões de embeddings
- Lidando com conteúdo multilíngue
Conceitos Principais
1. Comparação de Modelos de Embedding (2026)
| Modelo | Dimensões | Tokens Máx. | Ideal Para |
|---|---|---|---|
| voyage-3-large | 1024 | 32000 | Apps Claude (recomendado pela Anthropic) |
| voyage-3 | 1024 | 32000 | Apps Claude, custo-benefício |
| voyage-code-3 | 1024 | 32000 | Busca de código |
| voyage-finance-2 | 1024 | 32000 | Documentos financeiros |
| voyage-law-2 | 1024 | 32000 | Documentos legais |
| text-embedding-3-large | 3072 | 8191 | Apps OpenAI, alta precisão |
| text-embedding-3-small | 1536 | 8191 | Apps OpenAI, custo-benefício |
| bge-large-en-v1.5 | 1024 | 512 | Código aberto, implantação local |
| all-MiniLM-L6-v2 | 384 | 256 | Rápido, leve |
| multilingual-e5-large | 1024 | 512 | Multilíngue |
2. Pipeline de Embedding
Document → Chunking → Preprocessing → Embedding Model → Vector
↓
[Overlap, Size] [Clean, Normalize] [API/Local]
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
- Combine o modelo com o caso de uso: Código vs. texto corrido vs. multilíngue
- Divida em pedaços (chunking) com cuidado: Preserve os limites semânticos
- Normalize os embeddings: Para busca por similaridade de cosseno
- Agrupe requisições (batch): Mais eficiente do que uma por uma
- Armazene embeddings em cache: Evite recalcular para conteúdo estático
- Use Voyage AI para apps Claude: Recomendado pela Anthropic
O Que Não Fazer
- Não ignore os limites de tokens: Truncar (cortar) perde informação
- Não misture modelos de embedding: Espaços vetoriais incompatíveis
- Não pule o pré-processamento: Lixo entra, lixo sai
- Não divida em pedaços demais (over-chunk): Perde contexto importante
- Não se esqueça dos metadados: Essenciais para filtragem e depuração
Perguntas frequentes
O que são 'embeddings'?
São representações numéricas de textos que permitem que computadores comparem e entendam o significado das palavras e frases.
O que é 'chunking'?
É o processo de dividir um texto longo em pedaços menores para que a IA possa processar e entender melhor cada parte.
Por que é importante escolher o modelo certo?
Modelos diferentes são melhores para tipos de texto diferentes (código, finanças, etc.) e usar o modelo errado pode fazer a IA entender mal as informações.
Detalhes
Descrição original do autor
Select and optimize embedding models for semantic search and RAG applications. Use when choosing embedding models, implementing chunking strategies, or optimizing embedding quality for specific domains.
repo: wshobson/agents
Popularidade
- Estrelas no GitHub
- 41 mil
- Posição no ranking
- #4887
- 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
agent-architecture-audit
Faz seu agente verificar se tudo está funcionando corretamente. Ele encontra e conserta problemas em sistemas de IA, garantindo que funcionem como esperado.
affaan-m/ECC
agent-eval
Ajuda seu agente a comparar diferentes ferramentas de programação de IA. Ele mede qual é mais rápido, barato e confiável para realizar tarefas específicas.
affaan-m/ECC
agent-harness-construction
Faz seu agente entender melhor como realizar tarefas. Ele otimiza as ferramentas e instruções que o agente usa para aumentar suas chances de sucesso.
affaan-m/ECC