Agentes de código são ótimos em muitas coisas, mas alguns bugs continuam a deixá-los perplexos. É por isso que estamos apresentando o Debug Mode, um loop de agente totalmente novo baseado em informações de runtime e verificação humana.

Para criá-lo, examinamos as práticas das melhores pessoas em depuração do nosso time. Reunimos seus fluxos de trabalho em um modo de agente, equipando-o com ferramentas para instrumentar o código com logs de runtime, prompts que geram várias hipóteses sobre o que está dando errado e a capacidade de envolver você novamente para reproduzir o problema e verificar as correções.

O resultado é um processo interativo que corrige de forma confiável bugs que antes estavam além do alcance mesmo dos modelos mais avançados trabalhando sozinhos, ou que poderiam consumir um tempo significativo de desenvolvedor para serem resolvidos.

#Descreva o bug

Para começar, selecione Debug Mode no menu suspenso e descreva o bug com o máximo de detalhes que puder.

Em vez de tentar gerar imediatamente uma correção, o agente lê sua base de código e gera várias hipóteses sobre o que pode estar errado. Algumas serão ideias em que você mesmo pensaria, mas outras provavelmente serão abordagens que você não teria considerado.

Em seguida, o agente adiciona instruções de log ao seu código, projetadas para testar essas hipóteses. Isso prepara o agente para receber dados concretos sobre o que realmente está acontecendo quando o bug ocorre.

#Reproduzir o bug

Em seguida, vá para o seu aplicativo e reproduza o bug enquanto o agente coleta os logs de tempo de execução.

O agente consegue ver exatamente o que está acontecendo no seu código quando o bug ocorre: estados de variáveis, caminhos de execução, informações de temporização. Com esses dados, ele pode identificar a causa raiz e gerar uma correção específica. Muitas vezes isso é uma modificação precisa de duas ou três linhas, em vez das centenas de linhas de código especulativo que você receberia em uma interação padrão com um agente.

#Verifique a correção

Neste ponto, o Modo Debug pede para você reproduzir o bug mais uma vez com a correção proposta aplicada. Se o bug tiver sumido, você o marca como resolvido e o agente remove toda a instrumentação, deixando uma mudança limpa e mínima pronta para ser lançada.

Essa verificação com um humano no loop é fundamental. Às vezes os bugs são óbvios, mas em outras eles caem em uma área cinzenta em que a correção pode funcionar tecnicamente, mas não parecer ideal. O agente não consegue tomar essa decisão sozinho. Se você achar que o bug não foi corrigido, o agente adiciona mais logs, você reproduz de novo e ele refina a abordagem até que o problema seja realmente resolvido.

Esse tipo de iteração rápida é uma das formas como acreditamos que a programação com IA funciona melhor. O agente cuida do trabalho tedioso enquanto você toma as decisões rápidas que exigem julgamento humano. O resultado com o Modo Debug é que bugs complicados que antes estavam fora de alcance agora são corrigidos de forma consistente.

Leia a documentação do Modo Debug. Conheça todos os novos recursos no Cursor 2.2.