Pular para o conteúdo
Skillpedia
Agentes41 mil · #4898

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

https://github.com/wshobson/agents/blob/main/plugins/llm-finetuning/skills/finetuning-method-selection/SKILL.md

Mensagem pronta para colar

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

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/wshobson/agents/main/plugins/llm-finetuning/skills/finetuning-method-selection/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.

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

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas