Como usar IA para entender um erro de Python

Usar IA para entender um erro de Python funciona melhor quando você fornece a mensagem completa e um exemplo pequeno que reproduz o problema. Uma descrição como “não funciona” não mostra em qual etapa o programa parou.

Neste exercício, vamos investigar uma divisão por zero usando números fictícios. O objetivo é compreender a causa e definir o comportamento esperado, sem esconder a falha com uma correção que muda a regra do programa.

Leia a mensagem antes de pedir outra versão

A documentação oficial de erros e exceções diferencia erros de sintaxe de exceções que aparecem durante a execução. Essa distinção ajuda a escolher por onde começar a investigação.

Quando há um traceback, observe o tipo de exceção e as chamadas que levaram até ela. A última linha costuma resumir o erro, mas as linhas anteriores mostram o caminho percorrido.

Copie o texto preservando as quebras e a ordem. Antes de compartilhar, remova segredos, dados pessoais e caminhos que não sejam necessários para explicar o teste.

1. Reproduza em uma função pequena

Considere este exemplo fictício, que calcula uma média a partir de total e quantidade. O segundo argumento é zero, portanto a divisão não pode ser concluída.

def media(total, quantidade):
    return total / quantidade

print(media(12, 0))

A exceção esperada é ZeroDivisionError. Isso informa uma operação inválida nesse caso, mas ainda não diz qual deveria ser a política do seu aplicativo para uma quantidade vazia.

Teste em um ambiente Python preparado para experimentos, sem usar uma entrada de produção. Guarde também um caso normal, como media(12, 3), cujo resultado esperado é 4.

2. Descreva o que deveria acontecer

Você quer rejeitar a entrada, retornar ausência de resultado ou usar outra regra? Essas opções são decisões de comportamento, não detalhes que a IA deve escolher sem contexto.

Situação fictícia	Pergunta de diagnóstico
Quantidade positiva	O cálculo normal está correto?
Quantidade zero	Deve haver erro explicado ou ausência de média?
Campo ausente	A entrada foi validada antes do cálculo?
Texto no lugar do número	Existe conversão prevista pela regra?

Retornar zero automaticamente pode parecer resolver o erro e produzir uma média falsa. Antes de aceitar a sugestão, compare-a com a definição do indicador.

3. Peça explicação e hipótese verificável

Forneça versão do Python, código mínimo, entrada e mensagem de erro. Peça à IA que explique a relação entre esses elementos, sem reescrever todo o programa.

Explique este erro de Python usando o exemplo mínimo abaixo.
Mostre qual operação falha e com quais valores.
Separe causa observada de hipóteses que precisam de teste.
Não escolha sozinho o tratamento de quantidade zero.
Sugira uma alteração pequena após perguntar qual comportamento desejo.
Inclua um caso normal e um caso que reproduza a falha.

Se a explicação citar um erro diferente do que apareceu, volte ao traceback. Uma solução para um problema parecido pode não resolver a execução que você está investigando.

4. Altere uma condição por vez

Depois de definir a regra, modifique apenas o trecho necessário e execute novamente os mesmos exemplos. Compare a saída normal e o comportamento no caso excepcional.

Não acrescente um except genérico que ignora qualquer falha. Isso pode ocultar problemas diferentes, como um tipo de entrada incorreto, e dificultar a próxima investigação.

Quando o programa captura uma exceção, a resposta precisa continuar identificável para quem usa a função. Um valor vazio sem explicação pode transferir o problema para outra etapa.

5. Registre a causa confirmada

Anote entrada que reproduz, causa observada, regra escolhida e teste que verificou a alteração. Esse registro é mais útil que guardar apenas o último código sugerido pela IA.

O exercício termina quando você consegue explicar por que a falha acontecia e como o novo comportamento atende ao contrato da função.

Erros comuns são apagar partes do traceback, mudar várias coisas ao mesmo tempo e aceitar uma captura de exceção que apenas esconde o problema.

Perguntas frequentes

O que fornecer para explicar um erro de Python?

Inclua mensagem completa, versão, código mínimo, entrada usada e comportamento esperado, removendo dados sensíveis.

Retornar zero resolve uma divisão por zero?

Pode esconder o erro e produzir um resultado incorreto. O tratamento deve seguir a regra definida para a função.

Por que evitar uma captura genérica de exceções?

Ela pode ocultar falhas diferentes e impedir que você reconheça a causa real do problema.