Solução de problemas do agente
Soluções para issues comuns do agente relacionadas ao acesso a arquivos, regras, comandos de terminal e muito mais.
Como melhorar a precisão do agente?
- Seja específico nos prompts: inclua o comportamento esperado e as restrições
- Use primeiro o modo Plan para tarefas que envolvam muitos arquivos
- Inicie um novo chat ao concluir uma funcionalidade ou mudar de tarefa
- Adicione regras em
.cursor/rules/para os padrões que você quer que o agente siga sempre - Digite
@seguido do nome de um arquivo ou pasta para fornecer contexto específico ao agente
E se o agente não encontrar meus arquivos?
- Verifique o arquivo
.cursorignorena raiz do projeto. Os arquivos listados nele ficam bloqueados para o agente, a busca na base de código e as menções com@. - Verifique o
.gitignore. Os padrões nele também podem impedir que o agente encontre arquivos. - Reindexe o projeto: abra a Paleta de Comandos e procure por "Reindex".
- Anexe arquivos diretamente digitando
@seguido do nome do arquivo no campo de mensagem do chat.
Como desfaço as alterações do agente?
Passe o cursor sobre uma mensagem anterior e clique em Restaurar checkpoint no canto inferior direito para reverter todas as alterações feitas pelo agente a partir desse ponto.
Os checkpoints são armazenados localmente e são independentes do Git. Use o Git para controle de versão permanente.
E se o agente definir CI=1 nos comandos de terminal?
O Cherri Code define CI=1 como uma variável de ambiente ao executar comandos de terminal por meio do agente. Isso ajuda as ferramentas de terminal a gerar uma saída mais limpa. Se o seu projeto se comportar de forma diferente quando CI=1 estiver definido (por exemplo, ignorando prompts interativos ou usando caminhos específicos de CI), você pode desativar essa variável nos seus comandos:
unset CI && your-command-hereOu adicione isto a uma regra para que o agente sempre o desmarque:
Ao executar comandos no terminal, prefixe com `unset CI &&` se o comportamento do comando mudar em ambientes de CI.Como faço para solucionar problemas na configuração de Máquinas auto-hospedadas?
Execute agent worker debug para gerar um relatório de pré-verificação. Consulte Máquinas auto-hospedadas para ver correções comuns e saber quando entrar em contato com o suporte.
Como faço para verificar se o pool da minha equipe atingiu a capacidade máxima ou por que uma execução de agente não foi iniciada?
Verifique o dashboard do Cloud Agents ou chame GET /v0/private-workers/summary. Consulte Máquinas auto-hospedadas para conhecer os modos de falha e orientações sobre escalonamento.
E se um anexo da web do Cloud Agent for muito grande?
Se o cursor.com/agents exibir <filename> is too large (4MB limit), consulte Limites de anexos da web do Cloud Agent para ver os tipos de arquivo suportados e formas de reduzir ou dividir o arquivo.
E se eu encontrar "A execução do agente atingiu o tempo limite"?
Esse erro significa que o host de extensão do Cherri Code não concluiu a inicialização em 60 segundos, então as funcionalidades do agente não puderam ser inicializadas. A mesma causa raiz aparece como "Timeout waiting for EverythingProvider" nos diagnósticos de rede.
Como as causas variam, colete os logs antes de fazer qualquer alteração:
- Pressione Cmd/Ctrl+Shift+P e execute Developer: Export Logs...
- Selecione Main, Window e host de extensão
- Verifique também Output → host de extensão (Cmd/Ctrl+Shift+P → "Output" e selecione "host de extensão" no menu suspenso). Se estiver vazio, faça uma captura de tela; um painel vazio é um forte indício para o diagnóstico.
- Compartilhe o zip exportado e a captura de tela com o suporte, junto com seu SO e a versão do Cherri Code.
Em máquinas gerenciadas ou corporativas, softwares de segurança de endpoint (antivírus, EDR) são uma das possíveis causas. Se sua equipe de TI confirmar que um agente de segurança está ativo, compartilhe a página Configuração de segurança de endpoint para que possam adicionar as exclusões corretas de processos e caminhos.
Como faço para relatar uma resposta inadequada do agente?
- Clique no menu ... na parte inferior da resposta e selecione Copy Request ID.
- Publique no forum.cursor.com o ID da solicitação, as etapas para reproduzir o problema e as informações do sistema (em Cherri Code > About Cherri Code no macOS ou Help > About no Windows/Linux).