✳ IskraAI

Encontre o erro: como montar um pedido preciso para depuração de código

A ferramenta "Depurador de código" analisa o código e a mensagem de erro fornecidos, identifica causas prováveis e sugere uma correção mínima. Para obter uma resposta útil, é importante preencher corretamente três campos: código e mensagem de erro, plataforma ou aplicativo, contexto e requisitos. Neste artigo, veremos como montar um pedido preciso, quais detalhes são críticos e quais apenas confundirão. Não discutiremos questões gerais de inteligência artificial - apenas a prática de trabalho com esta ferramenta específica. Você aprenderá a formular solicitações de modo que o modelo encontre mais rapidamente a causa do falha e proponha uma solução realista.

Abrir ferramenta: Depurador de código ↗

Por que a precisão no pedido é necessária

O modelo não vê seu projeto, não executa o código e não tem acesso à documentação. Ele se baseia apenas no texto que você inseriu. Se no campo "Código e mensagem de erro" entrar um fragmento sem contexto, a resposta será geral ou incorreta. Quanto mais precisamente você descrever o que está acontecendo e o que deveria acontecer, maior a chance de obter uma correção mínima, e não um módulo reescrito do zero.

A precisão é importante também porque a ferramenta retorna um resultado em formato de texto. Você não terá a possibilidade de refinar o pedido em um diálogo. Tudo o que você deseja comunicar precisa caber em três campos. Limitações de comprimento: o primeiro campo até 8000 caracteres, os segundos e terceiros - até 1000 caracteres cada. Isso é suficiente para descrever um erro típico, mas não será suficiente para todo o projeto. Portanto, aprenda a destacar a essência.

Ruim: "Código não funciona, me ajude". Bom: "Python 3.11, script lê CSV e falha na linha 12 com KeyError: 'date'. Espero que a data seja pegada da coluna 'Date'. Aqui está o código e o rastreamento."

Campo "Código e mensagem de erro": o que incluir

Neste campo, coloque um fragmento mínimo reproduzível. Não copie todo o arquivo se o erro ocorre em uma função. Remova código comentado, imports desnecessários e tudo o que não se refere ao assunto. Certifique-se de adicionar o texto completo da mensagem de erro, incluindo o tipo de exceção e a linha. Se o erro estiver nos logs, forneça as últimas 10-20 linhas, e não apenas "algo deu errado".

Se o erro não for reproduzido com estabilidade, indique isso. Por exemplo: "IndexError aparece apenas quando a lista está vazia". O modelo deve entender as condições. Também é útil mostrar quais dados são inseridos como entrada: exemplo de array, strings, JSON. Mas não insira dados pessoais reais, tokens ou senhas. Substitua por valores condicionais.

Ruim: "print(items[3]) — IndexError". Bom: "items = [1, 2, 3]; print(items[3]) → IndexError: list index out of range. Espero imprimir o quarto elemento, mas a lista é mais curta".

Campo "Plataforma ou aplicativo": para que serve

A mesma erro pode ter causas diferentes no Python 3.8 e 3.12, no Node.js 18 e 20, no navegador Chrome e Safari. Especifique a linguagem, versão, sistema operacional, se for importante. Por exemplo: "Python 3.10, Windows 11, pandas 2.0". Se o erro estiver relacionado a um framework, nomeie-o e a versão: Django 4.2, React 18, .NET 6.

Não escreva "versão mais recente" - isso é indefinido. Se não souber a versão exata, especifique pelo menos a major. Para aplicações web, adicione o navegador e sua versão. Para móveis - dispositivo e SO. Essas informações ajudam o modelo a não propor sintaxe que não é suportada no seu ambiente.

Ruim: "Python". Bom: "Python 3.11.4, Ubuntu 22.04, biblioteca requests 2.31".

Campo "Contexto e requisitos": objetivo, limitações, formato

Aqui você explica o que o código deve fazer, quais limitações existem e o que é considerado uma correção bem-sucedida. Por exemplo: "A função deve retornar None se a lista estiver vazia, e não usar bibliotecas externas". Ou: "É necessário uma mudança mínima, sem reescrita de arquitetura". Se você já tentou consertar algo e não funcionou, escreva sobre isso - o modelo não repetirá a versão falha.

Especifique o formato da resposta, se importante: "Mostre apenas a linha corrigida e a explicação em um parágrafo". A ferramenta não tem configurações de estilo, então todos os desejos de formato precisam ser expressos em texto. Também vale mencionar se o código é didático e você quer entender a causa, e não apenas obter uma solução pronta.

Ruim: "Deixe normal". Bom: "Este é um exemplo didático. Quero entender por que ocorre IndexError e obter uma correção mínima com verificação de tamanho de lista. Sem alteração dos dados originais".

Exemplo de pedido ruim e bom

Um pedido ruim muitas vezes parece assim: no campo código colado todo o arquivo de 300 linhas, no campo plataforma - "computador", no contexto - "não funciona". O modelo pode encontrar um erro sintático, mas a causa provável permanecerá obscura. Além disso, um grande fragmento dispersa a atenção, e a resposta será superficial.

Um pedido bom contém três componentes: código mínimo com erro exato, ambiente específico e descrição clara do comportamento esperado. Por exemplo: código de cinco linhas, plataforma "Python 3.11, Windows", contexto "espero que o programa imprima o terceiro elemento, mas a lista contém apenas dois". Então a ferramenta com alta probabilidade apontará o erro de limite e sugerirá verificação de índice.

Pedido ruim: código: <todo o projeto>; plataforma: "notebook"; contexto: "erro". Pedido bom: código: `items = [1, 2, 3]; print(items[3])`; plataforma: "Python 3.11, Linux"; contexto: "preciso imprimir o quarto elemento, mas a lista é mais curta. Sugira correção mínima com verificação de tamanho".

Como verificar o resultado

Após receber a resposta, não a aplique imediatamente. Primeiro, verifique se a correção proposta corresponde ao seu contexto. Se o modelo sugerir alterar a estrutura de dados ou adicionar uma biblioteca, e você pediu uma mudança mínima, este é um sinal para refinar o pedido. Lembre-se: a ferramenta não executa código, então sua solução pode ser lógica, mas não funcional no seu ambiente.

Execute o fragmento corrigido em dados de teste. Se o erro desapareceu, verifique casos de fronteira: lista vazia, None, números negativos. Se o erro persistir, retorne ao pedido e adicione detalhes que faltam. Talvez você não tenha especificado a versão ou não tenha fornecido o texto completo da exceção. Um resultado - uma única iteração; para nova tentativa é necessário formar um novo pedido.

Após a resposta "adicione verificação if len(items) > 3" verifique: items = [1,2,3] - não deve haver exceção; items = [1,2,3,4] - deve imprimir 4.

Limitações da ferramenta

A ferramenta funciona apenas com texto. Ela não se conecta ao seu repositório, não vê o histórico de commits e não analisa dependências. Ela não pode executar testes ou verificar desempenho. As respostas podem conter erros, e a fila e disponibilidade variam. Não deve ser usado para auditoria de segurança ou análise de projetos grandes.

Comprimento máximo do primeiro campo - 8000 caracteres, dos restantes - 1000. Se o código for maior, reduza-o ao mínimo exemplo. A ferramenta não salva resultados automaticamente, não os envia por e-mail e não tem plano premium. Você pode copiar a resposta ou baixá-la em TXT. Para funcionar não é necessário registro. Todas essas limitações são importantes de considerar ao montar o pedido.

Se o erro ocorre apenas ao carregar arquivo de 10 MB, não insira o arquivo inteiro. Descreva a estrutura e forneça um pequeno exemplo de dados.

Um pedido preciso para a ferramenta "Depurador de código" economiza tempo e aumenta as chances de obter uma correção mínima útil. Especifique o ambiente específico, forneça código mínimo reproduzível com o texto completo do erro e descreva o comportamento esperado. Verifique a resposta em dados de teste e lembre-se das limitações: a ferramenta não executa código e não substitui um depurador. Seguindo estas recomendações, você encontrará mais rapidamente as causas de falhas e aprenderá com seus erros.

Abrir ferramenta: Depurador de código ↗

As traduções da interface são assistidas por máquina e podem precisar de refinamento.