Prompt Engineering para Executivos · Capítulo 3 de 28 · 13 min
Tirar do prompt as instruções que quebram nos modelos de 2026
Trocar prefill, budget_tokens, temperatura baixa, pense passo a passo e outros hábitos de 2024 pelo ajuste que funciona em Claude, GPT, Gemini, Grok e abertos.
Este capítulo faz parte do curso gratuito Prompt Engineering para Executivos.
Pedir "pense passo a passo", baixar a temperatura, forçar o uso de ferramenta e mais nove hábitos de 2024 hoje devolvem erro 400, recusa, resposta pior ou fatura maior nos modelos de 2026. Se você mantém prompt em produção, passe hoje o detector deste capítulo no prompt mais usado e corrija primeiro o que quebra a chamada.
O dano entra por portas diferentes, cada uma com prazo próprio. O erro 400 (o servidor recusa a chamada antes de o modelo ler o prompt) aparece no primeiro minuto de produção. A recusa do modelo chega como reclamação de usuário e costuma ser debitada ao fornecedor, embora a causa esteja no texto da equipe. Resposta pior e custo extra levam semanas para aparecer, porque só surgem quando alguém compara saídas ou abre a fatura.
Quase todas essas instruções nasceram para empurrar modelos que pensavam pouco, esqueciam regras e deixavam ferramentas de lado. Os modelos de 2026 raciocinam antes de responder e seguem o prompt ao pé da letra, então o empurrão virou excesso. Quem trocou só o nome do modelo na configuração descobre a lista pelo registro de erros.
Antipadrão de prompt (prompt anti-pattern) é a instrução ou o parâmetro que já foi recomendado e hoje produz o efeito contrário. A virada tem causa conhecida: entre 2025 e 2026, Anthropic, OpenAI, Google e xAI passaram o controle do raciocínio para um parâmetro de esforço, o botão que diz quanto o modelo pensa antes de responder. Ele se chama output_config.effort no Claude, reasoning.effort na OpenAI, thinking_level no Gemini e reasoning_effort no Grok. O que tentava cumprir esse papel por texto ou por parâmetro antigo ficou redundante ou proibido.
O "pense passo a passo", cujo mecanismo o capítulo anterior explica, é o exemplo típico: no Opus 5.5, a Anthropic relata que apagar a linha fez a resposta começar antes sem perda de qualidade.
Quem quer mais ou menos cuidado mexe no nível de esforço da chamada, sem gritar no texto; o capítulo seguinte mostra como escolher esse nível. A tabela reúne as 12 instruções que mais aparecem em prompts herdados.
12 instruções herdadas e a troca de cada uma
| Antipadrão | O que acontece em 2026 | O que fazer no lugar |
|---|---|---|
| Prefill: começar a resposta do assistente por "{" ou "Aqui está o JSON:" | Erro 400 no Claude da geração 4.6 em diante | Saída estruturada com esquema na chamada, ou a instrução "responda sem preâmbulo" |
| Limitar o raciocínio com budget_tokens | Erro 400 no Claude 4.7 em diante. No Gemini, thinking_budget fica só por compatibilidade | Nível de esforço: effort no Claude, thinking_level no Gemini, sem enviar os dois |
| Desligar o pensamento (thinking disabled, effort none ou minimal) | Erro 400 no Opus 5.5, no Fable 5.1, no GPT-6 Astra e no GPT-6.1 Sol. O Grok 4.7 não desliga | Esforço low. No Sonnet 5.5, thinking between_tools; no Haiku 5.5, disabled segue aceito até high |
| Forçar ferramenta com tool_choice any ou tool | Erro 400 no Sonnet 5.5, no Opus 5.5 e no Fable 5.1 | tool_choice auto, strict true e a condição de uso escrita na descrição da ferramenta |
| Temperatura baixa junto com raciocínio | Erro 400 no Opus 5.5 e no Fable 5.1. A OpenAI manda remover; no Gemini, pode gerar repetição em laço | Deixar temperature, top_p e top_k no padrão e controlar a variação por esquema e exemplos |
| "Escreva todo o seu raciocínio na resposta" | Recusa na categoria reasoning_extraction no Claude. O Gemini também desaconselha | Ler o resumo do raciocínio pela API: display summarized no Claude, reasoning.summary na OpenAI |
| "Pense passo a passo" | Redundante em modelo de raciocínio. A OpenAI diz que às vezes piora o resultado | Apagar a frase e subir o esforço quando a tarefa for difícil |
| Instrução contra preguiça: "se em dúvida, use a ferramenta" | No Claude 4.6 em diante, a ferramenta passa a ser chamada sem necessidade | Dizer quando usar e quando dispensar a ferramenta |
| Maiúsculas, exclamações, CRITICAL e MUST como ênfase | Modelo que segue a letra lê a ênfase como prioridade máxima e exagera na ação | Tom comum com a condição concreta: "use X quando o pedido citar Y" |
| Ameaça ("você será desligado") ou gorjeta prometida | Nenhum guia oficial de 2026 recomenda. O Google avisa que truques de modelos antigos fazem o Gemini analisar demais | Apagar e escrever o critério de acerto da tarefa |
| Ordens que se contradizem: "seja breve" e "explique tudo em detalhe" | O modelo gasta raciocínio tentando conciliar as duas | Escolher uma regra e dizer qual vence quando elas colidem |
| Muitos exemplos resolvidos em modelo de raciocínio | A OpenAI manda começar sem exemplos; com mais exemplos, o modelo copia os passos e erra o caso novo | Zero exemplos com o formato descrito; no Claude, de três a cinco exemplos curtos de formato |
As quatro primeiras linhas quebram a chamada. As demais pioram a resposta ou a conta sem gerar erro.
Fonte: Documentação de Anthropic, OpenAI, Google e xAI consultada em 13/10/2026; From Harm to Help, arXiv 2509.23196 (2025).
As quatro primeiras linhas entram na correção de hoje, porque derrubam a chamada. As outras pioram a resposta ou o custo e podem esperar a próxima revisão, desde que cada troca seja medida contra a versão anterior.
A família Claude concentra as quebras porque a Anthropic removeu recursos que os outros fornecedores apenas desaconselham, como o prefill (começar você mesmo a resposta do modelo) e o budget_tokens (o teto manual de tokens de raciocínio). O Sonnet 5.5, de 28/09/2026, acrescentou duas mudanças para quem migrou do Sonnet 5 trocando só o nome do modelo.
Duas quebras novas com o Claude Sonnet 5.5, de 28/09/2026
| Herdado do Sonnet 5 | No Sonnet 5.5 | O que usar |
|---|---|---|
| Desligar o pensamento com thinking disabled | O desligamento do pensamento inicial passa a ser feito por outro tipo de thinking | thinking between_tools, aceito nos esforços low, medium e high; para raciocínio sem ferramentas, pensamento adaptativo |
| Forçar ferramenta com tool_choice any ou tool | Erro 400 | tool_choice auto, ferramenta com strict true e a condição de uso na descrição |
Quem só troca o nome do modelo na configuração descobre as duas no primeiro dia de produção.
Fonte: Anthropic, Prompting best practices e Structured outputs, 13/10/2026.
Cada fornecedor aposentou o mesmo hábito por um caminho próprio, e a troca certa depende do modelo. O prefill, proibido no Claude, continua recomendado no Gemini como prefixo de resposta. A temperatura (o botão que dosa o acaso na escolha das palavras) dá erro no Opus 5.5, é aceita pelo Grok e não tem efeito no DeepSeek em modo de raciocínio. Antes de corrigir um prompt, escreva o modelo de destino no topo do arquivo.
Como fica em cada modelo
| Modelo | O que muda | Cuidado |
|---|---|---|
| Claude (Anthropic): Fable 5.1, Opus 5.5, Sonnet 5.5, Haiku 5.5 | Prefill, budget_tokens e tool_choice forçado dão erro 400. No Opus 5.5 e no Fable 5.1 o pensamento não desliga e temperatura fora do padrão dá 400 | Pedir o raciocínio na resposta pode gerar recusa. Em campo de justificativa de ferramenta, peça explicação. Few-shot de três a cinco exemplos segue recomendado |
| OpenAI (GPT): GPT-6 Astra, GPT-6.1 Sol, GPT-6 Luna | Com reasoning.effort diferente de none, remover temperature, top_p e top_logprobs. GPT-6 Astra recusa none; GPT-6.1 Sol recusa none e minimal | Começar zero-shot. Instrução de raciocínio passo a passo pode atrapalhar. tool_choice required e allowed_tools seguem válidos |
| Gemini (Google): 3.1 Pro Preview, 3.8 Flash | thinking_level substitui thinking_budget, e os dois juntos na mesma chamada não devem ir. No 3.8 Flash, minimal dá erro | Manter temperatura 1.0: valor menor pode causar laço ou queda de qualidade. Prefixo de resposta e poucos exemplos consistentes seguem recomendados |
| Grok (xAI): 4.5, 4.6, 4.7 | O raciocínio não desliga. presence_penalty, frequency_penalty e stop dão erro com modelo de raciocínio | Sem guia oficial de prompting. No 4.7, devolver o raciocínio criptografado inalterado na chamada seguinte |
| Modelos abertos: DeepSeek V4.1 Flash, Qwen3.8 | O pensamento liga e desliga por chave (thinking.type no DeepSeek, enable_thinking no Qwen). No modo de raciocínio do DeepSeek, temperature não tem efeito | O artigo do DeepSeek-R1 registra que few-shot degrada o desempenho. Com ferramentas, devolver o reasoning_content inteiro, senão erro 400 |
Item sem orientação oficial do fornecedor fica fora da linha dele.
Fonte: Anthropic, OpenAI, Google, xAI e DeepSeek (documentação oficial) e cartão do Qwen3.8-27B no Hugging Face, consultados em 13/10/2026; DeepSeek-R1, arXiv 2501.12948 (2025).
Os antipadrões de tom não geram erro e por isso duram mais. Maiúsculas, exclamações e "SEMPRE" foram escritos para modelos que ignoravam regras; nos modelos atuais, que seguem a letra, a ênfase empurra para o excesso. A Anthropic registra o efeito nas instruções contra preguiça: desde a geração 4.6, "se em dúvida, use a ferramenta" faz o Claude chamar a ferramenta sem necessidade. Ameaças e gorjetas não aparecem como recomendação em nenhum guia oficial de 2026, e o Google avisa que técnicas de prompt de modelos antigos podem fazer o Gemini analisar demais.
Contradição custa raciocínio. Quando o prompt pede "seja breve" e, três linhas abaixo, "explique cada decisão em detalhe", o modelo gasta tokens tentando conciliar as duas ordens, como descreve o guia de prompting do GPT-5 publicado pela OpenAI em 2025. O conserto é escolher uma regra e dizer qual vence quando elas colidem.
Exemplos resolvidos dentro do prompt (few-shot) seguem a dose por família vista no capítulo anterior. O dado novo é um estudo de 2025 que mediu, em modelo de raciocínio, a acurácia caindo conforme entram mais exemplos, porque o modelo copia os passos do exemplo em vez de resolver o caso novo.
Cinco linhas de prompt herdado e a reescrita para 2026
Evitar
Herdado
- IMPORTANTE!!! NUNCA invente dados.
- Se tiver qualquer dúvida, SEMPRE use a ferramenta buscar_pedido.
- Pense passo a passo e mostre todo o raciocínio na resposta.
- Seja breve. Explique cada decisão em detalhe.
- Se errar, você será desligado. Acertando, ganha uma gorjeta.
Fazer
Reescrito
- Quando o dado não estiver no pedido, escreva desconhecido e diga o que falta.
- Use buscar_pedido quando a mensagem citar número de pedido ou CPF; em dúvida geral, responda sem ela.
- Esforço high na chamada e resumo do raciocínio lido pela API, fora da resposta ao cliente.
- Responda em até quatro linhas e detalhe só quando houver reembolso.
- Acerto é categoria correta, prazo citado do pedido e nenhuma promessa fora da política.
Em produção, cada classe de dano aparece num tipo de fluxo. Nos três cenários ilustrativos abaixo, a migração quebra no jurídico, a conta sobe no atendimento e a resposta piora sem aviso na conciliação financeira.
Onde cada antipadrão costuma aparecer (cenários ilustrativos)
1 de 3Jurídico: a migração que parou no primeiro dia
Um escritório leva a revisão de contratos para o Opus 5.5 e mantém o prefill "{" e temperature 0. Toda chamada volta com erro 400. A troca é saída estruturada com esquema e parâmetros de amostragem no padrão.
- Severidade: quebra
- Correção em uma tarde
Atendimento no varejo: a ferramenta chamada até no bom-dia
O agente de uma loja tem "SEMPRE use buscar_pedido" no prompt e consulta o sistema em cada saudação. Cada chamada soma tokens de entrada e saída. A troca é escrever na descrição da ferramenta quando ela vale a pena.
- Severidade: custo
- Aparece na fatura do mês
Finanças: exemplos que ensinam a errar
Uma conciliação no GPT-6.1 Sol leva oito exemplos resolvidos e "pense passo a passo". O modelo repete os passos dos exemplos e erra o lançamento fora do padrão. A troca é zero exemplos, formato descrito e esforço high.
- Severidade: resposta pior
- Só aparece comparando saídas
O detector abaixo é um prompt que lê outro prompt. Ele recebe o texto e a configuração da chamada, aponta cada antipadrão com a severidade e a troca para o modelo de destino e devolve a versão corrigida. Rode-o num modelo atual com esforço high e confira as linhas de severidade QUEBRA contra a tabela por modelo antes de mexer na produção.
Guia prático: passar o detector de antipadrões num prompt de produção
Procedimento de 30 a 40 minutos para quem responde por um fluxo com IA em produção.
Passo 1: Exporte o prompt e a configuração real da chamada
Copie o texto que está em produção e os parâmetros enviados: modelo, temperatura, pensamento, tool_choice e prefill.
Deu certo quando: Você tem um arquivo com data, modelo de destino e todos os parâmetros.
Erro comum: Revisar a cópia da wiki, que costuma estar defasada em relação ao código.
Passo 2: Cole tudo no detector com o modelo de destino escrito
Troque o conteúdo de exemplo dentro de pasted_content pelo seu prompt e ajuste a tag modelo_de_destino.
Deu certo quando: A resposta abre com a linha DIAGNÓSTICO e o número de ocorrências.
Erro comum: Omitir a configuração da chamada, onde mora a maior parte dos erros 400.
Passo 3: Corrija primeiro as linhas QUEBRA
Prefill, budget_tokens, pensamento desligado, tool_choice forçado e temperatura nos modelos que a recusam.
Deu certo quando: A chamada roda no modelo de destino sem erro 400.
Erro comum: Misturar essa correção com a faxina de tom e perder a causa de uma regressão.
Passo 4: Troque o que degrada, uma mudança por vez
Para cada linha DEGRADA, CUSTO ou RECUSA, aplique a troca sugerida e rode 20 casos reais antes e depois.
Deu certo quando: A taxa de acerto se mantém ou sobe, e os tokens de saída caem.
Erro comum: Apagar os exemplos que fixavam o formato junto com a redundância.
Passo 5: Registre a versão nova com data e modelo
Guarde o prompt corrigido, a configuração e o resultado dos 20 casos no histórico do fluxo.
Deu certo quando: Qualquer pessoa da equipe acha a versão em uso e o motivo de cada troca.
Erro comum: Corrigir direto em produção sem guardar a versão anterior para comparar.
No fim você tem: Um prompt menor, que roda sem erro no modelo de destino, com a prova de que a faxina não custou qualidade.
DIAGNÓSTICO: 10 ocorrências, modelo de destino claude-sonnet-5-5
[QUEBRA] tool_choice: {type: "any"} → erro 400 no Sonnet 5.5. Troca: tool_choice auto, strict true e condição de uso na descrição de buscar_pedido.
[QUEBRA] budget_tokens: 4000 → erro 400 do Claude 4.7 em diante. Troca: thinking adaptive com output_config.effort medium.
[QUEBRA] prefill "{" → erro 400 do Claude 4.6 em diante. Troca: output_config.format com esquema JSON.
[RECUSA] "mostre todo o seu raciocínio na resposta" → pode disparar reasoning_extraction. Troca: display summarized e campo explicacao com até duas frases.
[DEGRADA] temperature: 0.2 → a Anthropic pede o padrão; no Opus 5.5 e no Fable 5.1 vira erro 400. Troca: remover.
[DEGRADA] "CRITICAL: You MUST SEMPRE" e "use a ferramenta!!!" → buscar_pedido chamada até em saudação. Troca: "Use buscar_pedido quando a mensagem citar número de pedido ou CPF."
[DEGRADA] "Pense passo a passo" → repete o pensamento adaptativo. Troca: apagar; subir o effort só se a taxa de acerto cair.
[CUSTO] "Seja breve" contra "Explique cada decisão em detalhe" → o modelo gasta raciocínio para conciliar. Troca: "Responda em até quatro linhas; detalhe só quando houver reembolso."
[CUSTO] dez exemplos com raciocínio em cinco passos → o modelo copia os passos. Troca: três a cinco exemplos curtos, só entrada e saída.
[RUÍDO] ameaça de desligamento e gorjeta → sem efeito documentado. Troca: apagar e escrever o critério de acerto.
PROMPT REESCRITO
Você é o assistente de atendimento da Loja Ipê.
Use buscar_pedido quando a mensagem citar número de pedido ou CPF; em dúvida geral, responda sem a ferramenta.
Responda em até quatro linhas e detalhe só quando houver reembolso.
Se o dado não estiver no pedido, escreva "desconhecido" e diga o que falta.
Acerto: categoria correta, prazo citado do pedido e nenhuma promessa fora da política de trocas.{
"model": "claude-sonnet-5-5",
"max_tokens": 4000,
"thinking": {
"type": "adaptive",
"display": "summarized"
},
"output_config": {
"effort": "medium",
"format": {
"type": "json_schema",
"schema": {
"type": "object",
"properties": {
"categoria": {
"type": "string",
"enum": [
"pedido",
"troca",
"reembolso",
"outro"
]
},
"resposta": {
"type": "string"
},
"explicacao": {
"type": "string"
}
},
"required": [
"categoria",
"resposta",
"explicacao"
],
"additionalProperties": false
}
}
},
"tool_choice": {
"type": "auto"
},
"tools": [
{
"name": "buscar_pedido",
"description": "Busca um pedido da Loja Ipê pelo número do pedido ou pelo CPF do cliente. Use quando a mensagem citar número de pedido ou CPF. Dispense em saudação e em dúvida geral sobre a loja. Devolve status, itens e prazo de entrega.",
"strict": true,
"input_schema": {
"type": "object",
"properties": {
"numero_ou_cpf": {
"type": "string"
}
},
"required": [
"numero_ou_cpf"
],
"additionalProperties": false
}
}
]
}Faxina que quebra o que funcionava
Remova o antipadrão e mantenha, escrita de outro jeito, a necessidade que o colocou ali.
- Exemplos de formato ficam: de três a cinco no Claude, poucos e consistentes no Gemini
- Em campo de justificativa de ferramenta, peça explicação e nunca raciocínio
- Trocar de modelo exige revisar a configuração da chamada junto com o texto
- Mudar o effort de topo entre chamadas invalida o cache do Claude
- Prefixo de resposta segue recomendado no Gemini; só o Claude o recusa
O teste: Para cada linha apagada, aponte a regra ou o parâmetro que passou a fazer o papel dela.
alexandrecaramaschi.com/educacao/frontends-com-vibecoding
Verificação rápida
Um fluxo no GPT-6.1 Sol envia temperature 0.2 e tem "pense passo a passo" no prompt. Qual troca resolve sem criar outro erro?
Faça hoje
Exporte o prompt de sistema e a configuração real do fluxo mais usado, cole os dois no detector com o modelo de destino escrito e corrija as linhas QUEBRA antes de qualquer outra. Em 30 a 40 minutos você terá a lista de trocas e uma chamada que roda sem erro 400. A faxina deu certo quando 20 casos reais mantêm a taxa de acerto da versão antiga com menos tokens de saída.
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
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Estude antes
- Prompt Engineering para Agentes: CoT, ReAct e a Fórmula da Clarezasugerido pelo grafoApresenta o conceito “Few-Shot Prompting”, usado em “Tirar do prompt as instruções que quebram nos modelos de 2026”.
- CursoSkills de IA com Vibecoding e Terminalsugerido pelo grafo3 capítulos de “Prompt Engineering para Executivos” usam conceitos apresentados em “Skills de IA com Vibecoding e Terminal”.
- CursoVídeo com IA: Claude Code, Codex e ElevenLabssugerido pelo grafo3 capítulos de “Prompt Engineering para Executivos” usam conceitos apresentados em “Vídeo com IA: Claude Code, Codex e ElevenLabs”.
- CursoMCP para quem decidesugerido pelo grafo2 capítulos de “Prompt Engineering para Executivos” usam conceitos apresentados em “MCP para quem decide”.
Depois, siga para
- CursoAgentes de IA Autônomos: Do Conceito à Produção
- CursoLLM FinOps: o custo da IA para quem assina o orçamentosugerido pelo grafo5 capítulos de “LLM FinOps: o custo da IA para quem assina o orçamento” usam conceitos apresentados em “Prompt Engineering para Executivos”.
- CursoRLM 2027sugerido pelo grafo2 capítulos de “RLM 2027” usam conceitos apresentados em “Prompt Engineering para Executivos”.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Letramento em IA para ExecutivosEscolha e combine modelos com governança e custoExaminar conexões de Escolha e combine modelos com governança e custo
- Agentes de código para executivosComparar Claude e Gemini depois da troca pelo AntigravityExaminar conexões de Comparar Claude e Gemini depois da troca pelo Antigravity
- Bastidores: Como Este Portal Foi ConstruídoBanca de modelos: pesquisa e redação com fonteExaminar conexões de Banca de modelos: pesquisa e redação com fonte
- RLM 2027Montar o laço gerar, avaliar e selecionar com um conjunto seladoExaminar conexões de Montar o laço gerar, avaliar e selecionar com um conjunto selado
Voltar ao capítulo anterior: Limpar do manual de prompt o que envelheceu desde 2024
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.
Capítulos vizinhos em Prompt Engineering para Executivos
- 01Entender o que mudou nos modelos e o vocabulário que você vai usar
- 02Limpar do manual de prompt o que envelheceu desde 2024
- 03Tirar do prompt as instruções que quebram nos modelos de 2026
- 04Escolher quanto raciocínio pagar em cada tarefa
- 05Diagnosticar se o erro da IA vem do prompt ou do contexto