finetuning-method-selection
Ajuda a escolher a melhor forma de treinar um modelo de IA. Decide se o treino é necessário e qual método usar para obter os melhores resultados.
O que ela faz
Esta ferramenta ajuda você a decidir se precisa treinar um modelo de IA e qual a melhor forma de fazer isso. Ela guia você para a técnica certa (como ensinar com exemplos ou com feedback) e o tamanho do modelo, evitando gastos desnecessários.
Quando usar
- ✓Quando você começa um projeto novo de treinamento de IA.
- ✓Se você não tem certeza se uma técnica mais simples resolveria o problema.
- ✓Ao escolher entre ensinar com preferências (gostei/não gostei) ou com recompensas (acerto/erro).
Exemplo do que pedir para a IA
“Preciso treinar um modelo para entender documentos técnicos da minha empresa. O que devo fazer?”
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 analisa seu problema para ver se treinar é realmente necessário. Se for, ela pergunta sobre o tipo de informação que você tem (exemplos, opiniões, acertos/erros) para sugerir o método e o modelo mais adequados.
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 finetuning-method-selectionOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/wshobson/agents/main/plugins/llm-finetuning/skills/finetuning-method-selection/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.
Seleção de Método de Fine-Tuning
Esta é a habilidade de roteamento para o ciclo de vida de fine-tuning: ela decide se o fine-tuning é a ferramenta certa, e se for, qual método e qual classe de tamanho de modelo base. Todas as outras habilidades neste plugin assumem que esse roteamento já ocorreu — comece aqui antes de abrir lora-qlora-recipes, preference-optimization, ou grpo-rlvr-training.
Quando Usar Esta Habilidade
- Iniciando qualquer esforço de fine-tuning, antes que um framework ou modelo base tenha sido escolhido.
- Incerto se RAG ou engenharia de prompt resolveriam o problema de forma mais barata do que o treinamento.
- Escolhendo entre otimização de preferência (família DPO) e um método de reforço (GRPO/RLVR) para a mesma tarefa subjacente.
- Dimensionando uma combinação candidata de modelo/método antes de se comprometer com uma execução.
Referência Rápida
| Situação | Rota |
|---|---|
| Fatos mudam frequentemente (preços, documentos, notícias) | RAG, não fine-tuning |
| Comportamento desejado ainda em definição | Engenharia de prompt |
| Conhecimento de domínio estável, ≥500MB de texto | CPT e depois SFT — veja Desvios Primeiro |
| Possui demonstrações de entrada/saída | SFT — veja lora-qlora-recipes |
| Possui pares de preferência ou aprovação/desaprovação | DPO/ORPO/KTO — veja preference-optimization |
| Possui um sinal verificável de sucesso/falha | GRPO+RLVR — veja grpo-rlvr-training |
| Ainda não possui um sistema de avaliação | Pare — veja eval-harness-first |
Desvios Primeiro
A maioria das solicitações que soam como "fazer fine-tuning disso" são melhor atendidas e mais baratas em outro lugar. Verifique estes desvios antes de iniciar uma execução de treinamento:
- Vinculado a conhecimento e volátil (a lacuna são fatos que mudam — preços, documentos, eventos atuais): roteie para RAG, não para fine-tuning. Um modelo com fine-tuning "congela" um snapshot; fatos voláteis ficam desatualizados imediatamente.
- Vinculado a comportamento e mutável (o comportamento desejado ainda está sendo definido, ou muda por solicitação): roteie para engenharia de prompt. Fine-tuning "congela" um comportamento; não congele um que ainda não se estabilizou.
- Conhecimento de domínio estável e denso: é aqui que entra o pré-treinamento contínuo (CPT), dimensionado pela quantidade de texto de domínio existente:
| Volume de texto de domínio | Rota |
|---|---|
| <10MB | Apenas RAG |
| 10MB–500MB | RAG + fine-tune |
| 500MB–10GB | CPT, depois SFT |
| >10GB | CPT obrigatório |
A taxa de aprendizado do CPT é ≈ 10% da LR de pré-treinamento. CPT é apenas para orientação neste plugin — o dimensionamento e a orientação da LR estão aqui, mas este plugin não executa uma execução de CPT.
Roteador de Método
Uma vez que os desvios são descartados, esta é a árvore de decisão completa (verbatim da pesquisa em que este plugin é construído):
New FACTS? volatile → RAG | stable+dense → CPT (LR ~10% of pretrain) → SFT
New BEHAVIOR? shifting → prompt-engineering | stable:
demos → SFT (LoRA/QLoRA, all-linear, α=2r)
preference pairs → DPO (SimPO if length-bias, ORPO if memory-bound)
unpaired 👍/👎 → KTO
verifiable success → RLVR + GRPO (DAPO/GSPO/Dr.GRPO per failure mode)
Deploy: FP8 (Hopper+) | NVFP4 (Blackwell scale) | AWQ (older) | GGUF+imatrix (edge)
BEFORE ANY OF THIS: the eval harness must exist first.
Leia a árvore de cima para baixo: responda "novos fatos ou novo comportamento", e então siga o ramo que corresponde ao formato dos dados em mãos (demonstrações, pares de preferência, aprovação/desaprovação, ou sucesso/falha verificável). O formato dos dados escolhe o método — não o contrário.
Exemplos de Roteamento Bem-Sucedidos
- "Os usuários querem que o assistente siga nossas macros de suporte exatamente." Comportamento estável e demonstrável a partir de transcrições → demonstrações → SFT.
- "Temos pares de respostas boas/ruins de aprovação/desaprovação de revisores, não pareados." → sinal não pareado → KTO, não DPO (DPO precisa de preferências pareadas).
- "O modelo já consegue resolver alguns desses problemas de matemática e podemos avaliar a correção automaticamente." → sinal de sucesso verificável → GRPO+RLVR, e somente após confirmar que o modelo tem sucesso pelo menos às vezes (veja Fatos Chave de Roteamento abaixo).
- "Queremos que o modelo conheça a página de preços desta semana." → fatos voláteis → RAG, sem nenhuma execução de treinamento.
Fatos Chave de Roteamento
- A escolha da função de perda tem baixo impacto. Um estudo com 240 H100 descobriu que a escolha do método valia ~1 ponto percentual versus ~50 pontos para a escala do modelo, e zero das 20 variantes de DPO superaram o DPO vanilla. Não gaste uma decisão de roteamento agonizando sobre a seleção de variantes de DPO — gaste-a em acertar o formato dos dados e a escala.
- DPO é para gosto, GRPO+RLVR é para raciocínio. Pares de preferência que codificam um julgamento subjetivo (tom, estilo, "qual resposta
…
Perguntas frequentes
Quando devo usar RAG em vez de treinar?
Use RAG se a informação muda com frequência (como preços ou notícias), pois treinar um modelo com dados desatualizados não é eficiente.
O que é SFT?
SFT (Supervised Fine-Tuning) é um método de treinamento onde você mostra exemplos de 'entrada' e 'saída' desejada para o modelo aprender.
O que são métodos de otimização de preferência (DPO, etc.)?
São métodos usados quando você tem pares de respostas e pode indicar qual é melhor, ensinando o modelo a preferir as respostas de maior qualidade.
Detalhes
Descrição original do autor
Decide whether to fine-tune at all, and route to the right method (SFT, DPO/ORPO/KTO, GRPO/RLVR, continued pretraining) and base model. Use when starting any fine-tuning effort, when unsure whether RAG or prompting would suffice, or when choosing between preference-optimization and reinforcement methods.
repo: wshobson/agents
Popularidade
- Estrelas no GitHub
- 41 mil
- Posição no ranking
- #4898
- 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