Por que medir antes de escolher
A quantização reduz a memória necessária para carregar os pesos, mas, por si só, não permite prever quanto a qualidade mudará em uma tarefa específica. Tampouco basta saber quantos parâmetros um modelo tem para antecipar a velocidade no seu equipamento: o processador, a memória disponível, a configuração de inferência, o contexto e a carga do sistema também influenciam. Uma decisão útil exige medir as alternativas com entradas representativas do uso real.
Um estudo de 2025 comparou a precisão, a latência até o primeiro token e a velocidade de geração de seis modelos executados localmente com Ollama em um sistema acadêmico de recuperação de informações. Esse trabalho oferece uma abordagem empírica pertinente, mas não demonstra que uma quantização GGUF específica preserve a qualidade em outros modelos, tarefas ou equipamentos. O protocolo a seguir transforma esse princípio em um método próprio: primeiro, defina o que significa acertar e qual desempenho você precisa; depois, compare cada configuração com uma referência explícita.
1. Defina a tarefa e a linha de base
Comece descrevendo o que o modelo fará em produção: quem o utilizará, quais entradas receberá, que saída deverá produzir, quais erros são mais custosos e quanto tempo pode levar. Uma avaliação de extração de campos exige medir a correspondência entre valores; respostas baseadas em documentos precisam ser verificadas quanto à fidelidade às fontes; para geração de código, é necessário executar testes, não apenas julgar se a resposta parece plausível. Se você misturar tarefas diferentes em uma única pontuação, poderá ocultar falhas importantes.
Prepare um conjunto de testes representativo da distribuição esperada: inclua tipos de entrada frequentes, casos-limite, entradas ambíguas e exemplos difíceis. Para cada caso, inclua uma referência verificável — uma resposta correta, os campos esperados, testes automatizados ou uma rubrica de avaliação — e registre sua origem. Separe um conjunto de desenvolvimento, que pode ser usado para ajustar prompts ou parâmetros, de outro de avaliação, que não deve ser usado repetidamente para otimização. Assim, você reduz o risco de escolher uma configuração que só funciona bem nos exemplos já vistos.
Projeto mínimo do conjunto de testes
Antes de executar os modelos, documente a tarefa, os exemplos, as saídas esperadas e os critérios de aprovação. Mantenha as entradas fixas e não altere a rubrica durante a comparação.
- 01Descreva uma tarefa específica e uma saída aceitável.
- 02Reúna exemplos representativos e casos difíceis, sem incluir dados sensíveis que não devam ser processados localmente.
- 03Anote a resposta esperada ou o método de verificação para cada exemplo.
- 04Reserve casos de avaliação que não serão usados para ajustar o prompt.
- 05Defina antecipadamente quais falhas são críticas e o limite mínimo que cada métrica precisa atingir.
2. Meça a qualidade de acordo com o trabalho real
Qualidade não é uma métrica única. Para respostas com uma solução conhecida, calcule a exatidão ou a taxa de acertos; para extração, avalie a correspondência exata por campo e por registro; para classificação, informe precisão e revocação quando falsos positivos e falsos negativos tiverem custos diferentes. Em tarefas de geração aberta, use uma rubrica explícita — por exemplo, factualidade, abrangência, clareza e utilidade — e guarde exemplos de erros para interpretar a pontuação. Uma avaliação automática ou feita por outro modelo pode ajudar a revisar muitos casos, mas não deve ser tratada como verdade de referência sem que sua validade para esse uso seja verificada.
Meça o formato como critério independente sempre que o sistema exigir JSON, uma estrutura fixa, uma chamada de ferramenta ou um limite de comprimento. Verifique se a saída pode ser analisada pelo validador real e se respeita os campos obrigatórios, os tipos, as enumerações e as restrições. Quando a amostragem não for determinística, registre também a consistência entre execuções: uma única resposta correta não demonstra que o sistema seja confiável. Em tarefas de risco, contabilize explicitamente os erros graves e estabeleça uma regra de recusa ou revisão humana antes de avaliar.
Métricas de qualidade conforme a tarefa
Escolha métricas relacionadas à falha que você deseja evitar; não calcule uma média entre indicadores incompatíveis sem explicar o que o resultado significa.
| Tipo de tarefa | Medição prática | O que verificar também |
|---|---|---|
| Classificação com rótulo esperado | Exatidão e, se houver classes desbalanceadas, precisão e revocação por classe | Custo relativo de falsos positivos e falsos negativos |
| Extração estruturada | Correspondência exata por campo e percentual de registros completamente corretos | Campos ausentes, tipos incorretos e JSON inválido |
| Resposta baseada em documentos | Rubrica de resposta correta e apoiada nas fontes disponíveis | Afirmações sem respaldo, citações incorretas e omissões críticas |
| Geração de código | Execução de testes automatizados e taxa de tarefas resolvidas | Erros de segurança, dependências e casos-limite |
| Redação aberta | Rubrica com critérios definidos e revisão de uma amostra | Variação entre execuções e adequação ao público |
3. Meça velocidade, latência e memória
Registre pelo menos a latência até o primeiro token e a velocidade de geração em tokens por segundo. A primeira indica quanto uma pessoa espera antes de ver uma resposta; a segunda descreve a produção após o início. Acrescente o tempo total até a conclusão, pois uma resposta longa pode demorar mesmo quando a taxa de geração é alta. Indique qual ferramenta fornece cada medida e o que ela inclui: carregamento inicial do modelo, preparação do prompt, processamento da entrada ou apenas geração.
Anote o consumo de memória durante a inferência e o contexto testado. O tamanho do arquivo GGUF não equivale automaticamente à memória total necessária: o contexto, o cache de atenção, o runtime e o sistema operacional também podem influenciar. Compare o mesmo modelo e a mesma tarefa com limite de contexto, parâmetros de geração e hardware idênticos. Se uma configuração não couber na memória e recorrer à troca com o armazenamento ou a outro caminho de execução, registre isso: a comparação deixa de ser equivalente.
Registro de desempenho
Guarde os valores de cada execução, não apenas uma média final. Depois, resuma a mediana e a faixa ou os percentis, sobretudo se o tempo de resposta for importante para os usuários.
| Campo | O que registrar | Por que importa |
|---|---|---|
| Primeira resposta | Latência até o primeiro token, com unidade e método | Representa o tempo de espera inicial |
| Geração | Tokens por segundo durante a saída | Permite comparar o ritmo de produção sob a mesma configuração |
| Resposta completa | Tempo total e comprimento da saída | Captura o custo percebido para concluir uma tarefa |
| Memória | Uso máximo observado e memória disponível | Verifica se a execução é viável no equipamento de destino |
| Condições | Hardware, runtime, versão, contexto e parâmetros | Torna a comparação interpretável e reproduzível |
4. Execute uma comparação controlada
Para atribuir diferenças à configuração avaliada, mantenha constantes o conjunto de entradas, o modelo de prompt, o limite de tokens, a temperatura e os demais parâmetros relevantes. Anote o nome e a revisão do modelo, a origem do arquivo GGUF e sua quantização exata. Registre também as versões do Ollama ou do LM Studio, o sistema operacional, o processador, o acelerador, a memória e as opções de descarregamento de camadas. Especifique no protocolo se o modelo já estava carregado ou se o carregamento inicial também foi medido.
Faça primeiro uma execução de preparação, se precisar carregar e estabilizar o modelo, e não a misture às medições habituais, a menos que a inicialização faça parte do requisito operacional. Repita cada teste várias vezes e informe a mediana e a variabilidade, não apenas a execução mais favorável. Se o aplicativo gerar saídas estocásticas, fixe a semente quando a ferramenta permitir ou avalie várias amostras com a mesma política. Alterne a ordem das configurações se a carga térmica ou do sistema puder mudar durante a sessão. Repita os testes em condições próximas às de implantação, não apenas com o equipamento recém-iniciado.
Protocolo reproduzível no Ollama ou LM Studio
Os nomes dos menus e das opções podem variar conforme a versão. Anote a configuração efetivamente usada, em vez de presumir que duas interfaces aplicam automaticamente os mesmos valores.
- 01Baixe ou identifique as variantes do mesmo modelo que deseja comparar; registre o arquivo e a quantização exata.
- 02Use a mesma máquina, o mesmo conjunto de prompts e os mesmos parâmetros de geração para cada variante.
- 03Fixe o contexto e verifique se todas as camadas são executadas no mesmo dispositivo ou se há descarregamento parcial para a CPU.
- 04Faça uma execução de aquecimento e, em seguida, várias repetições medidas.
- 05Guarde as saídas, os tempos, a memória, os erros e as versões do software em um registro comum.
- 06Confirme que as condições são iguais antes de atribuir uma diferença à quantização.
5. Decida entre quantização e tamanho do modelo
Primeiro, avalie se cada opção atende aos requisitos de qualidade e desempenho definidos previamente. Descarte configurações que não satisfaçam um critério crítico, mesmo que se destaquem em outra métrica. Entre as opções aprovadas, compare o tempo total, a latência inicial, a memória e a estabilidade do formato. Se uma quantização mais agressiva do modelo maior mantiver a qualidade necessária e couber no hardware, ela pode ser preferível; se perder precisão em uma tarefa sensível, um modelo menor com quantização mais conservadora pode oferecer resultados melhores. Não há uma regra geral que resolva essa escolha sem medições.
Também é possível que a melhor opção seja um modelo diferente do previsto inicialmente ou que o fluxo encaminhe tarefas simples a um modelo rápido e reserve outro mais capaz para casos difíceis. O estudo acadêmico com Ollama mencionado anteriormente encontrou diferenças de velocidade e precisão entre modelos no próprio sistema RAG; seus resultados não garantem o mesmo comportamento em outra configuração. Para justificar uma decisão técnica, conserve os resultados por tipo de tarefa e explique quais compromissos a equipe aceita. Se duas alternativas tiverem resultados muito próximos, considere a incerteza das medições e repita o teste antes de chegar a uma conclusão.
Matriz de decisão
A decisão tem duas etapas: primeiro, verificar se os requisitos foram atendidos; depois, escolher entre as opções válidas.
| Resultado da avaliação | Decisão sugerida | Verificação |
|---|---|---|
| Não atende a um requisito crítico de qualidade | Não implantar essa configuração no fluxo sem medidas de mitigação | Revisar os erros, o conjunto de testes e a necessidade de revisão humana |
| Atende à qualidade, mas excede a latência ou a memória permitida | Alterar a configuração ou o hardware e medir novamente | Confirmar o contexto, o descarregamento de camadas e a carga simultânea |
| Atende a todos os limites com margem estável | Considerar a configuração candidata para implantação controlada | Validar com dados operacionais e monitorar mudanças |
| Duas opções atendem aos requisitos e têm resultados próximos | Escolher conforme o custo operacional e a facilidade de manutenção; repetir o teste se a diferença for importante | Comparar a dispersão, o consumo e o comportamento em casos difíceis |
6. Limites e boas práticas
Um conjunto pequeno pode deixar passar erros raros; um conjunto muito parecido com os exemplos de desenvolvimento pode favorecer a configuração ajustada a esses casos. Uma pontuação agregada também pode ocultar falhas por idioma, comprimento, tipo de documento ou classe minoritária. Analise os resultados desagregados e guarde exemplos de erros. Se uma diferença estiver dentro da variação entre execuções, não a descreva como uma melhoria conclusiva sem mais repetições ou evidências.
Os resultados de uma pesquisa publicada em um ambiente acadêmico de RAG são evidências daquele trabalho e daquela configuração, não uma avaliação de GGUF nem uma recomendação universal. Da mesma forma, números genéricos sobre uma suposta perda fixa de qualidade por nível de quantização não substituem um teste com o modelo e a tarefa específicos. Documente a origem dos arquivos, evite incluir dados pessoais em prompts de teste sem autorização e estabeleça revisão humana ou mecanismos de recusa quando um erro puder causar danos. Depois da implantação, revise periodicamente uma amostra de uso real e repita o protocolo se o modelo, o runtime, o hardware ou o padrão de entradas mudar.
Lista de verificação antes de decidir
Uma conclusão é mais útil quando permite que outra pessoa repita a avaliação e entenda o que está fora do escopo.
- 01A tarefa e os custos dos erros estão definidos?
- 02O conjunto representa casos comuns e difíceis, com referências verificáveis?
- 03A qualidade é medida com critérios pertinentes, incluindo formato e falhas críticas?
- 04Foram medidos a primeira resposta, a geração, o tempo total e a memória?
- 05As condições foram mantidas constantes e as execuções foram repetidas?
- 06Foram preservados as versões, a configuração, os resultados e os limites de generalização?
Questões em aberto
- As evidências fornecidas sobre Ollama descrevem um estudo de 2025 em um sistema acadêmico de RAG; não avaliam especificamente a degradação de GGUF por quantização nem permitem generalizar os resultados para outras tarefas.
- A fonte técnica fornecida apresenta números gerais sobre perda de qualidade por quantização, mas as informações verificáveis não demonstram que sejam aplicáveis a qualquer modelo ou conjunto de testes. Por isso, este guia não os apresenta como garantias.
- Os nomes e controles disponíveis no Ollama e no LM Studio podem variar conforme a versão. O protocolo exige registrar a configuração efetivamente usada em cada execução.
Continue a explorar
Fontes consultadas
Correções e transparência
Se encontrar informação incorreta ou desatualizada, envie-nos a página e a fonte que devemos rever.
Propor uma correção