Modo Agent
O agente é o assistente de IA do Cherri Code. Ele explora sua base de código, edita vários arquivos, executa comandos de terminal e corrige erros por conta própria.
O que o modo Agent pode fazer?
O agente pode desenvolver funcionalidades do zero, refatorar código existente, corrigir bugs, escrever testes e executar comandos de shell. Dê a ele uma tarefa em linguagem simples, e ele descobrirá quais arquivos ler, quais alterações fazer e como verificar o resultado.
Como começo a usar o agente?
- Abra o painel do agente:
- Mac: Pressione CmdCtrl + I
- Windows/Linux: Pressione Ctrl + I
- Digite sua solicitação. Seja específico sobre o que deseja. Por exemplo: "Adicione um formulário de login à página inicial com campos de e-mail e senha."
- Pressione ReturnEnter. O agente começará a explorar sua base de código e fazer alterações.
- Acompanhe as edições na visualização de diff conforme são feitas.
Você também pode executar agentes no navegador em cursor.com/agents usando Cloud Agents.
Como faço para interromper o agente?
Clique no botão Parar para interromper o agente no meio de uma tarefa. Assim, você pode redirecioná-lo ou adotar uma abordagem diferente.
Como reviso as alterações do agente?
As edições do agente são aplicadas enquanto ele trabalha. Revise-as na visualização de diff e rejeite as que não quiser. Para revisões de PR, o Bugbot pode detectar bugs e problemas de segurança automaticamente.
Como faço para desfazer 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 após esse ponto. A restauração reverte apenas os arquivos; ela não remove mensagens da conversa. Para encurtar a conversa, bifurque o chat a partir de uma mensagem anterior.
O Agente pode delegar tarefas a subagentes?
Sim. O Agente pode iniciar subagentes especializados para realizar pesquisas, executar comandos de shell ou interagir com o navegador em paralelo. Cada subagente é executado em sua própria janela de contexto e retorna um resultado para a conversa principal. Você também pode criar subagentes personalizados adicionando arquivos Markdown a .cursor/agents/.
O agente pode gerar imagens?
Sim. O agente pode criar imagens a partir de descrições de texto ou imagens de referência. Isso é útil para mockups de UI, recursos de produto ou diagramas de arquitetura. As imagens geradas são salvas no seu projeto e exibidas diretamente no chat.
Posso enfileirar mensagens de acompanhamento enquanto o agente estiver trabalhando?
Sim. Envie sua próxima instrução enquanto o agente estiver ocupado. A mensagem ficará na fila e será executada automaticamente quando a tarefa atual terminar. Você pode arrastar as mensagens na fila para reordená-las.
O agente pode buscar contexto nas minhas conversas anteriores?
Sim. A Busca em conversas está disponível como uma ferramenta do agente. Quando o agente precisa de contexto de algo que você discutiu antes, ele pode consultar suas conversas anteriores por conta própria. Você não precisa se lembrar em qual chat foi.
Qual modo devo usar?
| Modo | Ideal para | Pode editar arquivos? |
|---|---|---|
| Agente | Criar funcionalidades, refatorar e corrigir bugs | Sim |
| Ask | Entender o código e explorar a arquitetura | Não (somente leitura) |
| Plan | Funcionalidades complexas em que você quer revisar a abordagem primeiro | Sim (depois de aprovar o plano) |
| Debug | Bugs complexos que exigem evidências em tempo de execução | Sim |
Use o Agente para a maioria das tarefas. Mude para o Ask quando quiser respostas sem alterações. Use o Plan para funcionalidades que envolvem vários arquivos e cuja abordagem você queira revisar. Use o Debug para bugs difíceis de reproduzir ou entender.
Como alterno entre os modos?
- Pressione Shift + Tab para percorrer os modos
- Clique no menu suspenso do seletor de modo no painel do agente
Cada modo usa seu próprio contexto; portanto, ao alternar de modo, uma nova janela de contexto é iniciada. Inicie um novo chat ao mudar de tarefa para obter os melhores resultados.
As regras se aplicam a todos os modos?
Sim. As regras do projeto, do usuário e da equipe se aplicam aos modos agente, Ask, Plan e Modo de Depuração. Elas são incluídas em todas as conversas, independentemente do modo que você esteja usando.