Pular para o conteúdo
iniciantesIA

Como pedir à IA para explicar um erro de código

Guia de programar: passo a passo, um prompt de exemplo para copiar e o que conferir antes de usar o resultado.

Cole a mensagem de erro completa, só o trecho de código necessário e as versões que você usa, e peça as causas prováveis antes da correção. Teste a solução fora de produção.

Nunca usou IA? Faça antes os passos 1 a 3 da trilha: eles explicam o que é um pedido (prompt) e como dar contexto.

Antes de colar qualquer coisa

  • Apague chaves de API, senhas, tokens, strings de conexão, URLs internas e dados de usuários da mensagem de erro e do código.
  • Se o código é da empresa, veja a política sobre ferramentas de IA antes de colar.

Passo a passo

  1. Passo 1

    Copie a mensagem de erro inteira

    Não escreva "deu erro". Copie a mensagem completa, com a linha do arquivo e o rastreamento da pilha, que mostra por onde o erro passou. A primeira linha costuma ser a causa; as outras mostram o caminho.

  2. Passo 2

    Cole o menor trecho que reproduz o problema

    Cole só a função ou o bloco em que o erro acontece, não o projeto todo. Tentar isolar o trecho muitas vezes já mostra o problema. Se o assistente receber 500 linhas, tende a comentar o que não importa.

  3. Passo 3

    Informe linguagem, versão e o que você esperava

    Diga a linguagem, a versão e as bibliotecas usadas, e o que o código deveria fazer. Uma função existe numa versão e não na outra; sem a versão, o assistente chuta.

  4. Passo 4

    Peça a causa antes da correção

    Peça "explique o que o erro significa, liste as três causas mais prováveis e como confirmar cada uma, e só depois sugira a correção". Assim você entende o problema e não só troca o código.

  5. Passo 5

    Teste a correção em ambiente de teste

    Aplique em uma cópia, rode, e confira se o erro sumiu e se nada mais quebrou. Se tiver testes automatizados, rode todos. Se a correção não funcionar, cole a nova mensagem de erro e diga o que você já fez.

O que esperar da resposta

Descrição do que pode vir, não a resposta de um assistente: não rodamos as ferramentas para escrever este guia, e o resultado muda de uma vez para outra.

  • Uma explicação do erro em palavras simples, que você deve conferir na documentação.
  • Uma lista de causas prováveis. A ordem não garante que a primeira seja a certa.
  • Um trecho de código corrigido, que pode usar função inexistente na sua versão ou mudar mais do que o necessário.
  • Um tom de certeza que não corresponde à certeza real.

Como conferir antes de usar

  • A função ou opção sugerida existe na documentação da sua versão?
  • A correção muda só o que precisa mudar?
  • O erro sumiu e os testes continuam passando?
  • Você entendeu o motivo? Se não, pergunte "por quê?" antes de aplicar.

Se a resposta vier fraca, peça assim

Pedidos de acompanhamento que cabem na mesma conversa (passo 5 da trilha).

“Explique por que esta causa é mais provável que as outras.”

Expõe o raciocínio e ajuda a descartar a causa errada.

“Escreva um teste que reproduz o erro.”

Cria uma prova de que a correção funcionou.

“Há um jeito mais simples de fazer isto?”

Pede uma alternativa menos complicada.

Quer mais modelos de prompt?

Para copiar prompts prontos por profissão e ver uma dica de IA por dia, visite o iadica.com.br, site irmão deste.

Perguntas frequentes

Posso colar o código da empresa no assistente?

Depende da política da empresa e dos termos do assistente. Pergunte ao responsável e nunca cole chaves, senhas nem dados de usuários.

A IA pode inventar função que não existe?

Pode. Por isso o guia manda conferir o nome na documentação oficial da sua versão antes de aplicar.

Quem está aprendendo deve pedir o código pronto?

Prefira pedir a explicação e tentar escrever você mesmo a correção. Copiar e colar resolve hoje e deixa o mesmo erro para amanhã.

Outros guias

Continue por aqui

A trilha ensina o método; o glossário explica as palavras difíceis.