Como usar
- Barra lateral de Agente em Segundo Plano: Use a aba de agente em segundo plano na barra lateral nativa do Cursor para ver todos os agentes em segundo plano associados à sua conta, buscar agentes existentes e iniciar novos.
- Modo de Agente em Segundo Plano: Pressione para ativar o modo de agente em segundo plano na interface.
Agentes em segundo plano exigem retenção de dados na ordem de alguns dias.
Configuração
Conexão com o GitHub
Configuração da lista de IPs permitidos
Configuração de ambiente base
- O comando de instalação roda antes de o agente iniciar e instala as dependências de runtime. Isso pode significar rodar
npm install
oubazel build
. - Terminais executam processos em segundo plano enquanto o agente trabalha — como iniciar um servidor web ou compilar arquivos protobuf.
COPY
pro projeto inteiro — a gente gerencia o workspace e faz checkout do commit correto. Ainda assim, mantém a instalação de dependências no script de instalação.
Insere quaisquer segredos necessários pro teu ambiente de dev — eles ficam armazenados criptografados em repouso (usando KMS) no nosso banco de dados e são fornecidos no ambiente do agente em segundo plano.
A configuração da máquina fica em .cursor/environment.json
, que pode ser commitada no teu repositório (recomendado) ou armazenada de forma privada. O fluxo de configuração te guia na criação do environment.json
.
Comandos de manutenção
install
do teu environment.json
. Esse comando é o que um desenvolvedor executaria ao trocar de branch — instalar quaisquer novas dependências.
Para a maioria das pessoas, o comando install
é npm install
ou bazel build
.
Para garantir uma inicialização rápida da máquina, armazenamos em cache o estado do disco depois que o comando install
roda. Projeta-o para rodar várias vezes. Apenas o estado do disco persiste a partir do comando install
— processos iniciados aqui não estarão em execução quando o agente começar.
Comandos de Inicialização
install
, a máquina inicia e a gente executa o comando start
e depois inicia quaisquer terminals
. Isso levanta processos que precisam estar ativos quando o agente for executado.
O comando start
muitas vezes pode ser pulado. Usa ele se teu ambiente de dev depende do Docker — coloca sudo service docker start
no comando start
.
terminals
são para o código do app. Esses terminais rodam numa sessão tmux
disponível pra ti e pro agente. Por exemplo, muitos repositórios de sites colocam npm run watch
como um terminal.
A especificação de environment.json
environment.json
pode ser assim:
Modelos
Preços
Segurança
- Concede privilégios de leitura e escrita pro nosso app do GitHub nos repositórios que tu quer editar. A gente usa isso pra clonar o repo e fazer alterações.
- Teu código roda na nossa infraestrutura da AWS em VMs isoladas e fica armazenado nos discos da VM enquanto o agente estiver ativo.
- O agente tem acesso à internet.
- O agente executa automaticamente todos os comandos de terminal, permitindo iterar nos testes. Isso difere do agente em foreground, que exige aprovação do usuário pra cada comando. A execução automática introduz risco de exfiltração de dados: atacantes podem executar ataques de prompt injection, induzindo o agente a enviar código pra sites maliciosos. Vê a explicação da OpenAI sobre riscos de prompt injection pra agentes em background.
- Se o modo de privacidade estiver desativado, a gente coleta prompts e ambientes de desenvolvimento pra melhorar o produto.
- Se tu desativar o modo de privacidade ao iniciar um agente em background e depois ativar durante a execução, o agente continua com o modo de privacidade desativado até concluir.
Configurações do dashboard
Configurações padrão
- Modelo padrão – o modelo usado quando uma execução não especifica um. Escolhe qualquer modelo que suporte o Max Mode.
- Repositório padrão – quando vazio, os agentes pedem pra tu escolher um repositório. Fornecer um repositório aqui deixa tu pular essa etapa.
- Branch base – a branch a partir da qual os agentes fazem fork ao criar pull requests. Deixa em branco pra usar a branch padrão do repositório.
Configurações de Segurança
- Restrições de usuário – escolhe Nenhuma (todos os membros podem iniciar agentes em segundo plano) ou Lista de permissão. Quando definido como Lista de permissão, você especifica exatamente quais colegas podem criar agentes.
- Follow-ups da equipe – quando ativado, qualquer pessoa no workspace pode adicionar mensagens de follow-up a um agente iniciado por outra pessoa. Desativa isso para restringir os follow-ups ao dono do agente e aos admins.
- Exibir resumo do agente – controla se o Cursor mostra as imagens de diff de arquivos e trechos de código do agente. Desativa isso se preferir não expor caminhos de arquivo ou código na barra lateral.
- Exibir resumo do agente em canais externos – estende o toggle anterior para o Slack ou qualquer canal externo que você conectou.