Resposta direta
Sem versionamento, a comparação só vale se a instrução for tratada como artefato de processo. Isso exige três elementos por mudança: identificador, responsável e data. Com eles, dá para comparar a versão atual com a anterior e saber qual delas gerou a resposta em uso. As alternativas de registro vão de planilha compartilhada a arquivo dentro do repositório, e diferem em rastreio, responsabilidade e custo de manutenção. A escolha depende de quantas pessoas precisam comparar, não do volume de instruções. Nenhuma delas substitui um caso de teste definido antes da mudança; sem esse caso, a comparação vira opinião sobre redação.
- Objetivo
- Comparar alternativas
- Formato indicado
- Workshop executivo
- Atualizado em
O que esta página acrescenta: Compara onde guardar e comparar a instrução sem histórico, por rastreio, responsável e custo, sem tratar ferramenta como solução.
Formas comuns de guardar a instrução
Na prática, a instrução fica em três lugares: uma planilha compartilhada, um arquivo de texto dentro do repositório do sistema, ou o corpo de um chamado. Cada lugar guarda a instrução atual, não a decisão que a produziu. Isso basta enquanto uma pessoa só mexe. Deixa de bastar quando outra pessoa assume a tarefa e precisa saber o que mudou.
Planilha é rápida de ler e difícil de auditar. Arquivo em repositório registra data e autor, mas raramente é aberto por quem não é técnico. Chamado tem o contexto da demanda e se perde quando o time troca de ferramenta de atendimento. A escolha depende de quem vai comparar depois.
O que separa uma alternativa da outra
Três critérios decidem. Rastreio: dá para saber qual versão gerou a resposta que o cliente recebeu. Responsabilidade: existe um nome ligado à última alteração. Custo de manutenção: manter o registro custa menos que reescrever a instrução inteira a cada troca de pessoa.
Em operação pequena, uma planilha com número de versão e data resolve. Em operação com auditoria ou várias equipes usando a mesma instrução, o registro precisa ser consultável por quem não escreveu o texto. O critério não é o volume de instruções, e sim quantas pessoas dependem da comparação.
O que nenhuma dessas formas resolve
Registrar versão não diz se a instrução ficou melhor. A comparação mostra diferença de texto e de resposta, mas não prova ganho sem um caso de teste combinado antes da mudança. Quando esse caso não existe, a discussão vira opinião sobre redação.
Nenhuma forma de guardar resolve instrução que muda toda semana sem dono definido. Nesse caso o problema é de processo, não de registro. O registro também não substitui revisão quando a instrução toca dado sensível ou decisão que afeta cliente.
Recurso prático
Da instrução solta ao registro comparável
- Dar à instrução um nome fixo e um número de versão que não mude com o texto.
- Registrar quem alterou, em que data e por qual motivo, antes de a nova versão entrar em uso.
- Guardar a versão anterior e a atual lado a lado, com o mesmo caso de teste aplicado às duas.
- Definir o critério da comparação: mudou o resultado esperado ou mudou apenas a redação.
O erro mais comum é comparar os dois textos lado a lado e concluir que a versão nova é melhor. Sem um caso de teste combinado antes, a diferença observada pode vir do dado de entrada, do dia ou de ajuste feito em outra parte da operação.
Sobre o que está escrito aqui
Conceitos relacionados: instrução padrão · histórico de versão · responsável pela alteração · caso de teste · log de mudança. Exemplos são ilustrativos. Não há cliente, resultado, preço, prazo ou certificação nesta página. Quando o formato indicado é Workshop executivo, ele descreve uma possibilidade de trabalho — a conversa inicial avalia contexto e aderência.
Para continuar
- IA aplicada e agentes — Página central do tema
- Agente que só roda com alguém olhando: o que… — agentes sem supervisão
- Agente rodando sem ninguém olhar: como medir — agentes sem supervisão
Páginas relacionadas
O mesmo problema em outro objetivo
- Instrução de IA sem versionamento: como localizar a origem — Diagnosticar
- Instrução de IA sem versionamento: o que muda sem registro — Organizar um processo
- Instrução sem versionamento: como medir o efeito — Explicar medição
- Instrução de IA sem versionamento: por onde começar o registro — Orientar implementação
Outras leituras em IA aplicada e agentes
- Instrução de IA sem versão: como manter histórico e dono — Descreve como tratar instruções de IA como artefato controlado: dono, histórico de versão, critério de mudança e ponto de revisão.
- Modelo escolhido por reputação: como colocar em teste — Descreve como tratar a indicação de mercado como lista de candidatos e usar critério de aceite, teste pequeno e registro para sustentar a escolha.
- Ferramenta de IA por área: como medir sem padrão comum — Descreve como medir ferramentas de IA contratadas por áreas diferentes, sem métrica comum: o que padronizar, o que medir por área e onde a comparação engana.
- Agente que age sem trilha de auditoria: o que registrar — O que registrar quando um agente executa ações, onde guardar o registro e quais decisões precisam de aprovação antes da execução.
- Resultado de IA sem registro de origem: o que exigir — Descreve como avaliar e contratar entregas de IA quando não há registro de origem, com critérios de prova, responsabilidade e limites de uso.