Pular para o conteúdo principal

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​

  1. Visite cursor.sh e baixe a versão apropriada para seu sistema operacional
  2. Execute o instalador e siga as instruções na tela
  3. Inicie o Cursor após a conclusão da instalação
  4. Faça login com sua conta ou crie uma nova
  5. 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:

  1. Abra um projeto no Cursor
  2. Pressione Cmd/Ctrl+Shift+A para abrir o painel de chat
  3. Descreva uma tarefa complexa como "Refatorar nosso sistema de autenticação para usar tokens JWT"
  4. O Agente criará uma lista de tarefas estruturada com dependências
  5. Cada item pode ser rastreado enquanto o Agente trabalha nele
  6. 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:

  1. Enquanto o Agente está executando uma tarefa, digite sua próxima instrução
  2. Envie a mensagem, e ela será colocada na fila para processamento
  3. Acesse a fila clicando no ícone "Fila" na interface de chat
  4. Reorganize as tarefas na fila arrastando-as no painel de fila
  5. 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:

  1. Ative as Memórias em Configurações → Regras, se ainda não estiverem ativadas
  2. O Cursor gerará automaticamente memórias com base em suas interações
  3. Visualize e gerencie memórias em Configurações → Memórias
  4. Para criar manualmente uma memória, use o formato: "Lembre-se que [informação importante]"
  5. 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:

  1. Conecte seu repositório GitHub em Configurações → Integrações → GitHub
  2. Permita que o Cursor indexe seus PRs (isso acontece automaticamente)
  3. Pesquise PRs usando linguagem natural na barra de pesquisa com o prefixo @pr
  4. Exemplo: @pr refatoração de autenticação
  5. 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:

  1. Abra o arquivo com conflitos no editor
  2. Clique no botão "Resolver no Chat" que aparece
  3. O Agente analisará os conflitos e sugerirá resoluções
  4. Revise as alterações sugeridas e aplique-as se forem apropriadas
  5. 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:

  1. Acesse o Agente em segundo plano clicando no ícone de nuvem no chat ou pressionando Cmd/Ctrl+E
  2. Os Agentes em segundo plano agora seguem automaticamente os modelos de PR da sua equipe
  3. As alterações nos branches do agente são automaticamente buscadas
  4. Os conflitos são apresentados como acompanhamentos acionáveis
  5. Faça commit diretamente da barra lateral com o novo botão "Commit de Alterações"
  6. 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:

  1. Use @codebase seguido de sua consulta para pesquisar na base de código
  2. Para pesquisas mais específicas, tente @file, @folders ou @symbol
  3. Os resultados agora são contextualmente mais relevantes e precisos
  4. 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:

  1. Atualize para a versão mais recente do patch (pelo menos 1.2.1)
  2. Reinicie o Cursor para limpar a memória
  3. Verifique o Gerenciador de Tarefas/Monitor de Atividades para uso excessivo de memória
  4. Desative e reative as extensões se os problemas persistirem

Problemas de Renderização de Chat​

Para problemas de exibição de chat:

  1. Use Cmd/Ctrl+Shift+P para abrir a paleta de comandos
  2. Digite "Developer: Reload Window" e pressione Enter
  3. 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:

  1. Saia e faça login novamente
  2. Verifique sua conexão com a internet
  3. Certifique-se de que sua conta tenha as permissões apropriadas
  4. Entre em contato com o suporte se os problemas persistirem

Melhores Práticas para o Cursor 1.2​

  1. Organize Projetos: Use espaços de trabalho multi-raiz para repositórios relacionados
  2. Aproveite o Planejamento do Agente: Comece com tarefas de alto nível e deixe o Agente decompô-las
  3. Use a Memória Efetivamente: Instrua explicitamente o Cursor a lembrar de convenções importantes do projeto
  4. Otimize Prompts: Seja específico em suas solicitações para obter melhores resultados
  5. 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!