trace-to-training-data
Ajuda seu agente a transformar dados de avaliação e logs em exemplos de treinamento para modelos de IA. É útil para melhorar o modelo usando dados reais de como ele se saiu.
O que ela faz
Esta ferramenta transforma resultados de testes de IA em dados que podem ser usados para treinar a IA novamente. Ela pega exemplos de como a IA acertou ou errou e os organiza para que a IA aprenda com eles.
Quando usar
- ✓Quando você tem testes de IA que já foram avaliados e quer usá-los para treinar a IA.
- ✓Quando a IA comete erros e você quer transformar esses erros em exemplos de aprendizado.
- ✓Quando você quer criar pares de 'bom vs. ruim' para ensinar a IA a escolher a melhor resposta.
Exemplo do que pedir para a IA
“Transforme os resultados deste teste em dados de treinamento para a IA.”
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 pega os resultados de testes que já foram marcados como 'certo' ou 'errado' e os formata. Ela organiza essas informações para que a IA possa usá-las como exemplos para aprender.
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 trace-to-training-dataOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/wshobson/agents/main/plugins/llm-finetuning/skills/trace-to-training-data/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.
Convertendo para Dados de Treinamento
Esta habilidade assume que eval-harness-first já avaliou os traces que estão sendo
convertidos aqui — goldens, graders e runs/<run-id>/results.json existem antes do início da conversão.
Esta é a vantagem do ciclo que a habilidade nomeia em seu próprio fluxo:
"os mesmos traces rotulados se tornam o conjunto de treinamento." A conversão
acontece aqui; a avaliação já ocorreu a montante.
Entrada: traces avaliados —
eval/goldens.jsonl mais
runs/<run-id>/results.json, cada
linha carregando um task_id, uma
verdict do avaliador e um
reward quando a tarefa suporta uma
pontuação escalar (pontuação do juiz,
crédito parcial de execução ou um
verificador RLVR):
{"task_id": "t-042", "trace_id": "t-042-a3",
"messages": [{"role": "user", "content": "..."}],
"verdict": "pass", "reward": 0.91,
"grader": "exact_match"}
Formato de saída: linhas com formato
exatamente igual à tabela de Seleção de
Formato de dataset-curation — linhas de
messages SFT ou pares de
prompt/chosen/rejected DPO —
para que a saída desta habilidade seja
a entrada dessa habilidade sem
nenhuma etapa de reformatação entre elas.
O Princípio
O harness de avaliação já fez o trabalho de
rotulagem: cada trace em results.json carrega um veredito,
e frequentemente uma recompensa, antes que esta
habilidade o toque. Converter um trace avaliado em uma
linha de treinamento é mecânico — escolher um formato
da tabela de dataset-curation,
mapear campos, escrever JSONL.
A curadoria é o trabalho que
resta — quais traces atingem uma barra de
qualidade, quais pares são informativos e quais
linhas nunca devem entrar no conjunto de treinamento.
Trate qualquer etapa de conversão que
exija reavaliação de um trace como um
sinal de que o harness está faltando um
avaliador, não uma lacuna que esta habilidade
deva cobrir. Um trace sem veredito ou recompensa
ainda não é conversível — encaminhe-o de volta para
eval-harness-first primeiro,
não o rotule manualmente aqui para
desbloquear a conversão.
SFT a partir de Traces
- Mantenha a fração de maior recompensa de trajetórias bem-sucedidas, não todas as que passaram. Classifique os traces que passaram por recompensa e pegue uma fração (o padrão Agente-relâmpago) em vez de cada trace que apenas atingiu a barra de aprovação — um trace que mal passou é um sinal SFT mais fraco do que um que pontuou bem acima do limite.
- Falhas corrigidas por especialistas se tornam exemplos SFT ouro diretamente (o padrão Langfuse) — quando um humano edita a saída de um trace falho em uma correta, essa correção não precisa de limite de recompensa; um humano já a validou. Encaminhe as correções diretamente para o conjunto SFT.
- Mascaramento em nível de passo supera a exclusão de trajetória inteira para traces de múltiplos passos. Quando apenas alguns passos em uma trajetória de múltiplos passos estão ruins, mascare a perda nos passos ruins e mantenha os bons, em vez de descartar a trajetória inteira. SRFT relata 32,2% contra 30,9% no SWE-bench para mascaramento de crítico em nível de passo sobre exclusão de trajetória — uma diferença real, embora modesta, do corte mais granular.
Pares de Preferência a partir de Traces
- Construa pares a partir de trajetórias que passaram versus as que falharam na MESMA tarefa, nunca a partir de traces de melhor e pior pontuação não relacionados retirados de tarefas diferentes — pares entre tarefas ensinam o modelo a preferir uma tarefa em vez de outra, não uma resposta em vez de outra.
- Selecione o membro rejeitado em
μ−2σ da distribuição de recompensa
para essa tarefa, nunca o
mínimo absoluto.
A seção Construção de Pares de
preference-optimizationcontém a fórmula de seleção completa; esta habilidade fornece os traces avaliados que ela consome. - Seleção por delta de juiz pontuado reduz o volume de pares sem reduzir o sinal. Pontue cada par candidato pelo delta do juiz escolhido menos rejeitado e mantenha apenas o subconjunto de maior delta — os top 5k de um pool de 16,5k candidatos corresponderam ao resultado downstream do pool completo. Construa o conjunto completo de candidatos primeiro, depois filtre por delta; não limite a geração em 5k antecipadamente.
Higiene
- Verifique segredos e PII antes que qualquer linha seja enviada, e redaque o que for encontrado. Traces originados de logs de produção podem conter credenciais, chaves de API, tokens ou dados de clientes — execute uma verificação de segredo/PII em cada linha SFT e DPO e redaque as correspondências; a conversão falha fechada (a linha é descartada, não enviada com o conteúdo bruto) se campos sensíveis permanecerem após a redação. Nunca cometa segredos.
- Goldens de avaliação nunca devem vazar
para dados de treinamento. Mantenha
cada ID de
eval/goldens.jsonlfora de cada conjunto SFT e DPO convertido — um trace que também aparece como um golden é treinado no item exato contra o qual o checkpoint será avaliado posteriormente,
…
Perguntas frequentes
O que são 'traces'?
'Traces' são como registros detalhados de como a IA tentou resolver um problema, mostrando os passos que ela seguiu.
Por que é importante usar apenas os melhores resultados?
Usar apenas os melhores resultados (e não todos os que passaram) ajuda a IA a aprender com exemplos de alta qualidade, tornando o aprendizado mais eficiente.
O que acontece se os dados de teste contiverem informações sensíveis?
A ferramenta verifica se há informações sensíveis ou pessoais e as remove antes de transformar os dados, garantindo a privacidade e segurança.
Detalhes
Descrição original do autor
Convert evaluation traces and production logs into SFT examples and preference pairs. Use when graded traces or failure examples exist and need to become training data, when applying rejection sampling to model outputs, or when building DPO pairs from passing and failing runs.
repo: wshobson/agents
Popularidade
- Estrelas no GitHub
- 41 mil
- Posição no ranking
- #4903
- 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