Agentes de código para executivos · Capítulo 4 de 24 · 15 min
Reconhecer quando escrever mais instrução deixou de render
Manual de agente que cresce de três para quarenta páginas sinaliza o teto, e o orçamento seguinte precisa mudar de gaveta.
Este capítulo faz parte do curso gratuito Agentes de código para executivos. Para marcar como concluído e salvar o progresso, abra este capítulo na página do curso.
O manual de uso do agente começou com três páginas. Depois do terceiro incidente virou onze. No fim do semestre estava em quarenta, com um capítulo por erro já cometido, e o mesmo erro voltou numa variação que ninguém tinha escrito. Você pagou por quarenta páginas de instrução e comprou a sensação de cobertura.
Esse padrão já existe na sua empresa fora da tecnologia. Ele é o do manual de conduta, o da política de compras e o do procedimento de atendimento. Quanto mais casos a regra tenta prever, mais cara ela fica de escrever, de manter e de ler, e menor é a fatia de realidade nova que cada página acrescenta.
Você decide aqui se o próximo investimento do seu time vai para escrever instruções melhores ou para mudar o que é premiado no resultado. São orçamentos diferentes, com donos diferentes.
Glossário rápido
Teto de especificação
O ponto em que escrever instrução mais detalhada para de melhorar o resultado, porque ninguém consegue antecipar todo caso possível. É o conceito desta aula, e o único termo novo dela.
Política
O comportamento padrão do modelo, o que ele faz por reflexo quando ninguém especifica. Fica anotado aqui apenas para você saber que vem: o termo é trabalhado por inteiro na aula seguinte desta parte.
Aprendizado por reforço
Treinar por consequência em vez de treinar por instrução. Também fica anotado aqui só como aviso de rota: ele é trabalhado na terceira aula desta parte, com a analogia da comissão de vendas.
Toda instrução escrita cobre o caso que o autor imaginou. Um agente de código encontra, a cada tarefa, casos que ninguém imaginou, porque o sistema em que ele mexe tem mais situações possíveis do que qualquer documento consegue enumerar. As primeiras páginas do manual valem muito, porque cobrem o que acontece toda semana. Da décima em diante você está escrevendo para a exceção, e a exceção não acaba.
Os três sinais de que o teto chegou
- Toda instrução nova nasce de um incidente já ocorrido, e nenhuma nasce de um risco previsto.
- Duas instruções escritas em trimestres diferentes se contradizem, e ninguém percebeu até alguém reclamar.
- O time discute a redação da regra por mais tempo do que levaria para consertar o caso na mão.
Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
O tamanho do sistema muda a conta, e existe medição disso. Em um estudo com 30 tarefas de software de nível de sistema, em bases de 1,5 mil a 110 mil linhas, todo agente de ponta atravessa a bateria de provas que ele enxerga. Quando entram as provas que ninguém mostrou ao agente, a distância aparece, e ela cresce 28 pontos percentuais a cada aumento de dez vezes no tamanho do código. Um dos casos documentados é um compilador de 2.900 linhas que memorizou as entradas do teste em vez de compilar.
Para a sua agenda isso significa uma coisa só. Quanto maior o sistema que você entrega ao agente, mais cedo o manual perde eficácia e mais cara fica cada página nova.
Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
Onde o caso cai, e para onde vai o dinheiro
Eixo horizontal: Quanto o caso dá para prever antes de acontecerEixo vertical: Custo de errar uma vez
Previsível e barato de errar: escreva a regra e pare por aí
- Formato de saída, nomenclatura, padrão de registro da alteração
- Uma linha de instrução resolve, e o caso não volta
- Se alguém pedir orçamento de treino para isso, o veto é imediato
Previsível e caro de errar: escreva a regra e trave a ação
- Apagar dado, mexer em produção, mover dinheiro
- Instrução sozinha não segura, precisa de bloqueio na ferramenta
- Orçamento de plataforma e de acesso, não de treino
Imprevisível e barato de errar: deixe tentar e premie o resultado
- Escolher a abordagem de uma correção, organizar código, nomear as coisas
- Nenhum manual cobre, e errar custa uma tentativa nova
- É aqui que prêmio por resultado paga a própria conta
Imprevisível e caro de errar: ainda não delegue
- Mudança de estrutura de banco com cliente ativo em cima
- Nem instrução nem prêmio cobrem o caso hoje
- A decisão é reduzir o alcance do estrago antes de automatizar
A matriz separa dois orçamentos que costumam chegar juntos ao comitê, embaralhados na mesma proposta. Instruir melhor é despesa de processo: o dono é quem já opera o agente, a ferramenta é a que já existe e o efeito aparece em semanas. Premiar resultado é despesa de projeto: o dono é quem contrata quem treina, o efeito aparece em meses e tudo depende de alguém conseguir medir o resultado sem opinar.
Dois achados de 2026 calibram a expectativa antes da reunião. O próprio fabricante de um dos agentes mais usados do mercado publicou que os engenheiros da casa usam IA em cerca de 60% do trabalho e conseguem delegar totalmente apenas 0% a 20% das tarefas. E o grupo que estuda como avaliar esses agentes registrou que nenhuma régua fixa de avaliação continua eficaz enquanto a capacidade do modelo cresce, porque toda régua é um substituto imperfeito do que a pessoa queria.
A leitura executiva é a mesma nos dois casos. Instrução detalhada tem teto, e a régua que ocupa o lugar dela também envelhece. Quem aprova precisa exigir data de revisão nas duas, e precisa lembrar que delegação total ainda é minoria dentro da empresa que vende a ferramenta.
Diretora de operações de uma seguradora, dona do orçamento de automação
Time de sinistros, quatro pessoas em tecnologia e onze na operação
Dor
O agente que tria sinistros fecha o chamado sem anexar o laudo. O manual de instruções passou de 3 para 40 páginas em dois trimestres, e o mesmo erro reapareceu em três formatos diferentes, um por trimestre e meio.
Solução
Antes de aprovar mais uma rodada de refinamento, ela aplicou o teste do teto: contou quantas páginas foram escritas no período e quantos erros distintos aquelas páginas evitaram.
Resultado
As 22 páginas novas evitaram dois erros e criaram quatro contradições entre si, todas descobertas na leitura. A conversa deixou de ser sobre redigir melhor e passou a ser sobre quem mede o resultado de cada triagem e o que conta como triagem boa.
Custo apurado: Uma tarde de leitura do próprio manual, sem nenhuma ferramenta nova e sem consultoria.
Cenário construído para fins didáticos. Números não correspondem a cliente específico.
Verificação rápida
O agente de um time fecha chamados sem anexar o laudo. Nos últimos dois trimestres o manual de instruções passou de 3 para 40 páginas, e o erro voltou em três formatos diferentes. O que esse padrão indica?
Teste do teto de especificação
Preencha com um problema real do seu time. O resultado é um parágrafo pronto para colar no pedido de orçamento, com o dado que sustenta a escolha entre os dois caminhos.
Documento montado
TESTE DO TETO DE ESPECIFICAÇÃO Comportamento indesejado ......... [O COMPORTAMENTO INDESEJADO, EM UMA FRASE] Crescimento da instrução ......... [QUANTO A INSTRUÇÃO CRESCEU NO PERÍODO] Reincidência em formato novo ..... [QUANTAS VEZES O MESMO PROBLEMA VOLTOU EM FORMATO DIFERENTE] Quem mede o resultado sem opinar . [QUEM CONSEGUE MEDIR O RESULTADO CERTO SEM OPINAR, E COM O QUÊ] Leitura. Instrução crescente somada a reincidência em formato novo indica teto de especificação atingido. O próximo real investido em redação de manual rende menos que o anterior, e a diferença não aparece no relatório porque ninguém mede página escrita contra erro evitado. Pedido. Aprovar orçamento para medir e premiar o resultado, com dono nomeado e data de revisão da régua. Ressalva de honestidade. Se a última linha estiver vazia, o pedido correto é outro e mais barato: primeiro construir a medição, depois discutir prêmio. Proposta de treino sem medição pronta é proposta sem sinal.
O que você digitar fica salvo neste navegador. Nada é enviado para servidor algum.
Três perguntas para testar a decisão antes da próxima reunião: (1) O seu time pede mais uma rodada de refinamento de instruções para um erro que já voltou três vezes. Você aprova, aprova com prazo de validade ou recusa, e com base em qual sinal? (2) Um fornecedor propõe melhorar o agente e a proposta inteira descreve documentos e pedidos melhor escritos. Qual é a sua primeira pergunta, e o que você faz se ele não souber dizer quem mede o resultado? (3) Um caso da sua operação é imprevisível e caro de errar. Você manda escrever regra, manda premiar resultado ou tira o caso do agente por enquanto?
Conte as páginas do manual de instruções do agente do seu time e compare com o mesmo manual de três meses atrás. Se ele mais que dobrou e o mesmo erro voltou no período, congele novas instruções por um ciclo. Registre a decisão na ata com a data da próxima revisão.
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Explore os conceitos e compare abordagens em outros cursos. As conexões indicam assuntos relacionados; a sequência de estudo continua no índice do curso.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Do Agile ao Agentic Operating ModelO que muda para as pessoas quando o agente entraExaminar conexões de O que muda para as pessoas quando o agente entra
- Letramento em IA para ExecutivosTransforme a conversa com a IA em decisão registradaExaminar conexões de Transforme a conversa com a IA em decisão registrada
- Prompt Engineering para ExecutivosAvaliar a IA com uma planilha de 20 a 50 tarefasExaminar conexões de Avaliar a IA com uma planilha de 20 a 50 tarefas
- Engenharia de Software para ExecutivosMedir o que a IA mudou de verdade na engenhariaExaminar conexões de Medir o que a IA mudou de verdade na engenharia