Cursor agente
O agente é o assistente do Cursor que pode concluir tarefas complexas de programação de forma independente, executar comandos de terminal e editar código. Acesse-o no painel lateral com Cmd+ICtrl+I.
Saiba mais sobre como os agentes funcionam e desenvolva mais rápido.
Como o agente funciona
Um agente é composto por três componentes:
- Instruções: O prompt do sistema e as regras que orientam o comportamento do agente
- Ferramentas: Edição de arquivos, busca na base de código, execução no terminal e muito mais
- Modelo: O modelo de agente escolhido para a tarefa
O agente do Cursor orquestra esses componentes para cada modelo compatível, ajustando as instruções e as ferramentas para cada modelo de ponta. À medida que novos modelos são lançados, você pode se concentrar no desenvolvimento de software enquanto o Cursor cuida das otimizações específicas de cada modelo.
Ferramentas
As ferramentas são os componentes básicos do agente. Elas permitem pesquisar na sua base de código e na web, encontrar informações relevantes, editar arquivos, executar comandos de terminal e muito mais.
Para entender como as chamadas de ferramenta funcionam internamente, consulte os fundamentos de chamadas de ferramenta.
Não há limite para o número de chamadas de ferramenta que o agente pode fazer durante uma tarefa.
Pesquise arquivos por nome, leia estruturas de diretórios e encontre palavras-chave ou padrões exatos nos arquivos.
Gere consultas de pesquisa e pesquise na web.
Recupere regras específicas com base no tipo e na descrição.
Leia de forma inteligente o conteúdo de um arquivo. Também oferece suporte a arquivos de imagem (.png, .jpg, .gif, .webp, .svg) e os inclui no contexto da conversa para análise por modelos com recursos de visão.
Sugira edições em arquivos e aplique-as automaticamente.
Execute comandos de terminal e monitore a saída. Por padrão, o Cursor usa o primeiro perfil de terminal disponível.
Para definir seu perfil de terminal preferido:
- Abra a Paleta de Comandos (
Cmd/Ctrl+Shift+P) - Procure por "Terminal: Select Default Profile"
- Escolha o perfil desejado
Controle um navegador para fazer capturas de tela, testar aplicações e verificar alterações visuais. O agente pode navegar por páginas, interagir com elementos e capturar o estado atual para análise. Consulte a documentação do navegador para mais detalhes.
Gere imagens a partir de descrições de texto ou imagens de referência. Útil para criar mockups de UI, recursos de produto e visualizar diagramas de arquitetura. Por padrão, as imagens são salvas na pasta assets/ do seu projeto e exibidas no chat.
Faça perguntas para esclarecer dúvidas durante uma tarefa. Enquanto aguarda sua resposta, o agente continua lendo arquivos, fazendo edições ou executando comandos. Sua resposta é incorporada assim que chega.
Checkpoints
Os checkpoints salvam snapshots da sua base de código durante uma sessão do agente. O agente os cria automaticamente antes de fazer alterações significativas, registrando o estado de todos os arquivos modificados.
Se o agente seguir pelo caminho errado, clique em qualquer checkpoint na linha do tempo do chat para visualizar seus arquivos naquele momento e, em seguida, restaure-os para reverter todos os arquivos àquele estado. Você também pode restaurar usando o botão Restore Checkpoint em solicitações anteriores ou o botão + ao passar o cursor sobre uma mensagem.
Os checkpoints são úteis para trabalho exploratório, refatorações complexas e desenvolvimento iterativo, quando você precisa de pontos seguros para reverter alterações.
Os checkpoints são armazenados localmente e são independentes do Git. Use-os apenas para desfazer alterações feitas pelo agente; use o Git para controle de versão permanente.
Mensagens enfileiradas
Enfileire mensagens de acompanhamento enquanto o agente trabalha na tarefa atual. Suas instruções aguardam na fila e são executadas automaticamente quando estiverem prontas.
Como usar a fila
- Enquanto o agente estiver trabalhando, digite sua próxima instrução
- Pressione Enter para adicioná-la à fila
- As mensagens aparecem em ordem abaixo da tarefa ativa
- Arraste as mensagens na fila para reordená-las conforme necessário
- O agente as processará em sequência após concluir a tarefa
Atalhos de teclado
Enquanto o agente estiver trabalhando:
- Pressione Enter para enfileirar sua mensagem (ela será enviada quando o agente concluir a tarefa atual)
- Pressione Cmd+EnterCtrl+Enter para enviar imediatamente, sem passar pela fila
Mensagens imediatas
Ao usar Cmd+EnterCtrl+Enter para enviar uma mensagem imediatamente, ela é adicionada à mensagem de usuário mais recente no chat e processada na hora, sem entrar na fila.
- Sua mensagem é anexada aos resultados das ferramentas e enviada imediatamente
- Isso proporciona uma experiência mais ágil para mensagens de acompanhamento urgentes
- Use esta opção quando precisar interromper ou redirecionar o trabalho atual do agente