Modo de Depuração
O Modo de Depuração ajuda você a encontrar a causa raiz e corrigir bugs difíceis de reproduzir ou entender. Em vez de escrever código imediatamente, o agente gera hipóteses, adiciona instruções de log e usa informações de tempo de execução para identificar o problema exato antes de aplicar uma correção direcionada.
Quando usar o Modo de Depuração
O Modo de Depuração é mais útil para:
- Bugs que você consegue reproduzir, mas não consegue entender: Quando você sabe que algo está errado, mas a causa não fica clara ao ler o código
- Condições de corrida e problemas de temporização: Problemas que dependem da ordem de execução ou do comportamento assíncrono
- Problemas de desempenho e vazamentos de memória: Issues que exigem profiling em tempo de execução para serem compreendidas
- Regressões em que algo funcionava antes: Quando você precisa rastrear o que mudou
Quando as interações padrão com o agente têm dificuldade para lidar com um bug, o Modo de Depuração oferece uma abordagem diferente, baseada em evidências de tempo de execução em vez de tentar adivinhar correções.
Como funciona
-
Explorar e formular hipóteses: O agente explora arquivos relevantes, cria contexto e gera várias hipóteses sobre possíveis causas raiz.
-
Adicionar instrumentação: O agente adiciona instruções de log que enviam dados para um servidor de depuração local executado em uma extensão do Cursor.
-
Reproduzir o bug: O Modo de Depuração pede que você reproduza o bug e fornece etapas específicas. Isso mantém você no processo e garante que o agente capture o comportamento real em tempo de execução.
-
Analisar os logs: Após a reprodução, o agente analisa os logs coletados para identificar a causa raiz com base em evidências do tempo de execução.
-
Fazer uma correção direcionada: O agente faz uma correção focada que resolve diretamente a causa raiz, geralmente com apenas algumas linhas de código.
-
Verificar e limpar: Você pode executar novamente as etapas de reprodução para verificar a correção. Depois da confirmação, o agente remove toda a instrumentação.
Dicas para o Modo de Depuração
- Forneça contexto detalhado: Quanto mais você descrever o bug e como reproduzi-lo, melhor será a instrumentação do agente. Inclua mensagens de erro, rastreamentos de pilha e etapas específicas.
- Siga exatamente as etapas de reprodução: Execute as etapas fornecidas pelo agente para garantir que os logs capturem o problema real.
- Reproduza várias vezes, se necessário: Reproduzir o bug várias vezes pode ajudar o agente a identificar problemas complexos, como condições de corrida.
- Seja específico sobre o comportamento esperado e o comportamento real: Ajude o agente a entender o que deveria acontecer e o que está acontecendo.
Alternar modos
- Use o menu suspenso do seletor de modo no agente
- Pressione Shift+Tab para alternar rapidamente