Primeiros Passos com o Cursor 1.2: Um Guia Abrangente
O Cursor 1.2 representa uma atualização significativa da IDE de codificação baseada em IA, introduzindo novos recursos poderosos como planejamento de Agente, processamento de contexto aprimorado e preenchimento de Tab mais rápido. Este guia o orientará em tudo o que você precisa saber para começar com o Cursor 1.2 e aproveitar ao máximo seus recursos mais recentes.
O que há de novo no Cursor 1.2
Antes de mergulharmos na configuração e uso, vamos explorar as principais melhorias desta versão:
- Tarefas do Agente: Os agentes agora planejam com listas de tarefas estruturadas para trabalhos de longo prazo
- Fila de Mensagens: Coloque mensagens de acompanhamento na fila para o Agente enquanto ele trabalha em tarefas atuais
- Memórias (GA): O recurso de Memórias agora está geralmente disponível com qualidade aprimorada
- Indexação e Busca de PRs: Pesquise e entenda PRs assim como faz com arquivos
- Embeddings Aprimorados: Busca de código mais precisa com um novo modelo de embedding
- Tab mais Rápido: Preenchimentos de Tab estão ~100ms mais rápidos com 30% de redução no tempo até o primeiro token (TTFT)
- Resolução de Conflitos de Merge: Deixe o Agente resolver conflitos de merge diretamente no chat
Instalação e Configuração
Requisitos do Sistema
- Sistemas Operacionais: Windows 10/11, macOS 10.15+ ou Linux (Debian/Ubuntu)
- Memória: Mínimo de 8 GB de RAM, 16 GB recomendados
- Armazenamento: Pelo menos 1 GB de espaço livre em disco
- Conexão com a Internet: Necessária para recursos de IA
Passos de Instalação
- Visite cursor.sh e baixe a versão apropriada para seu sistema operacional
- Execute o instalador e siga as instruções na tela
- Inicie o Cursor após a conclusão da instalação
- Faça login com sua conta ou crie uma nova
- Se estiver atualizando de uma versão anterior, o Cursor atualizará automaticamente para a versão 1.2
Recursos Principais e Como Usá-los
Tarefas do Agente
O recurso de Tarefas do Agente do Cursor 1.2 ajuda a decompor tarefas complexas em etapas gerenciáveis:
- Abra um projeto no Cursor
- Pressione
Cmd/Ctrl+Shift+A
para abrir o painel de chat - Descreva uma tarefa complexa como "Refatorar nosso sistema de autenticação para usar tokens JWT"
- O Agente criará uma lista de tarefas estruturada com dependências
- Cada item pode ser rastreado enquanto o Agente trabalha nele
- Para ver as tarefas no Slack, certifique-se de que a integração com o Slack esteja configurada em Dashboard → Integrations
Fila de Mensagens
Com a fila de mensagens, você pode planejar com antecedência enquanto o Agente trabalha:
- Enquanto o Agente está executando uma tarefa, digite sua próxima instrução
- Envie a mensagem, e ela será colocada na fila para processamento
- Acesse a fila clicando no ícone "Fila" na interface de chat
- Reorganize as tarefas na fila arrastando-as no painel de fila
- Inicie a execução clicando em "Executar Fila"
Usando Memórias
O recurso de Memórias ajuda o Cursor a lembrar de informações específicas do projeto:
- Ative as Memórias em Configurações → Regras, se ainda não estiverem ativadas
- O Cursor gerará automaticamente memórias com base em suas interações
- Visualize e gerencie memórias em Configurações → Memórias
- Para criar manualmente uma memória, use o formato: "Lembre-se que [informação importante]"
- Faça referência às memórias mencionando conceitos relacionados em seus prompts
Indexação e Busca de PRs
Para aproveitar os novos recursos de indexação de PRs:
- Conecte seu repositório GitHub em Configurações → Integrações → GitHub
- Permita que o Cursor indexe seus PRs (isso acontece automaticamente)
- Pesquise PRs usando linguagem natural na barra de pesquisa com o prefixo
@pr
- Exemplo:
@pr refatoração de autenticação
- Clique em um PR para ver seu resumo, comentários e alterações de código associadas
Resolução de Conflitos de Merge
Ao encontrar conflitos de merge:
- Abra o arquivo com conflitos no editor
- Clique no botão "Resolver no Chat" que aparece
- O Agente analisará os conflitos e sugerirá resoluções
- Revise as alterações sugeridas e aplique-as se forem apropriadas
- Faça commit das alterações resolvidas
Recursos Avançados
Melhorias no Agente em Segundo Plano
O Cursor 1.2 aprimora a funcionalidade do Agente em segundo plano:
- Acesse o Agente em segundo plano clicando no ícone de nuvem no chat ou pressionando
Cmd/Ctrl+E
- Os Agentes em segundo plano agora seguem automaticamente os modelos de PR da sua equipe
- As alterações nos branches do agente são automaticamente buscadas
- Os conflitos são apresentados como acompanhamentos acionáveis
- Faça commit diretamente da barra lateral com o novo botão "Commit de Alterações"
- Use links profundos do Slack ou da web para abrir o repositório associado
Embeddings Aprimorados para Busca Semântica
O novo modelo de embedding fornece resultados de pesquisa mais precisos:
- Use
@codebase
seguido de sua consulta para pesquisar na base de código - Para pesquisas mais específicas, tente
@file
,@folders
ou@symbol
- Os resultados agora são contextualmente mais relevantes e precisos
- Pesquise em vários repositórios em espaços de trabalho multi-raiz
Solucionando Problemas Comuns
Vazamentos de Memória
Se você experimentar degradação de desempenho ao longo do tempo:
- Atualize para a versão mais recente do patch (pelo menos 1.2.1)
- Reinicie o Cursor para limpar a memória
- Verifique o Gerenciador de Tarefas/Monitor de Atividades para uso excessivo de memória
- Desative e reative as extensões se os problemas persistirem
Problemas de Renderização de Chat
Para problemas de exibição de chat:
- Use
Cmd/Ctrl+Shift+P
para abrir a paleta de comandos - Digite "Developer: Reload Window" e pressione Enter
- Se os problemas persistirem, tente "Limpar Histórico de Chat" no menu de chat
Problemas de Autenticação de Token
Se encontrar problemas de autenticação:
- Saia e faça login novamente
- Verifique sua conexão com a internet
- Certifique-se de que sua conta tenha as permissões apropriadas
- Entre em contato com o suporte se os problemas persistirem
Melhores Práticas para o Cursor 1.2
- Organize Projetos: Use espaços de trabalho multi-raiz para repositórios relacionados
- Aproveite o Planejamento do Agente: Comece com tarefas de alto nível e deixe o Agente decompô-las
- Use a Memória Efetivamente: Instrua explicitamente o Cursor a lembrar de convenções importantes do projeto
- Otimize Prompts: Seja específico em suas solicitações para obter melhores resultados
- Aprenda Atalhos de Teclado: Domine combinações de teclas para acelerar seu fluxo de trabalho
Conclusão
O Cursor 1.2 representa um avanço significativo no desenvolvimento assistido por IA. Com capacidades de planejamento aprimoradas, desempenho mais rápido e melhor compreensão de contexto, ele oferece uma experiência de codificação mais produtiva. Seguindo este guia, você deve estar bem equipado para aproveitar todo o potencial do Cursor 1.2 em seu fluxo de trabalho de desenvolvimento.
Lembre-se de verificar atualizações regularmente, pois a equipe do Cursor frequentemente lança patches com melhorias adicionais e correções de bugs.
Boa codificação com o Cursor 1.2!