Pular para o conteúdo principal

Usando Agentes em Segundo Plano no Cursor para Automação

Cursor Background Agents

O Cursor 1.0 introduziu Agentes em Segundo Plano - um recurso poderoso que permite que agentes de IA executem tarefas em segundo plano sem bloquear seu IDE. Este guia cobre como configurar, gerenciar e aproveitar agentes em segundo plano para máxima produtividade.

O que são Agentes em Segundo Plano?​

Agentes em Segundo Plano permitem:

  • Tarefas de longa duração que continuam enquanto você trabalha em outras coisas
  • Processamento paralelo de várias tarefas independentes
  • Operações assíncronas como testes, builds e análises
  • Tarefas agendadas que rodam em horários específicos

Pré-requisitos​

  • Cursor versão 1.0 ou mais recente
  • Plano Pro ou superior (agentes em segundo plano podem exigir um nível pago)
  • Projetos com tarefas que podem rodar independentemente

Iniciando um Agente em Segundo Plano​

Método 1: Menu de Contexto​

  1. Abra o Composer (Cmd/Ctrl + I)
  2. Digite a descrição da sua tarefa
  3. Clique no menu ... (Mais Ações)
  4. Selecione Executar em Segundo Plano

Método 2: Comando​

@background Analise toda a base de código em busca de vulnerabilidades de segurança e relate os resultados.

Método 3: Atalho de Teclado​

  1. Componha sua tarefa
  2. Pressione Cmd/Ctrl + Shift + B (se configurado)
  3. O agente inicia em segundo plano

Casos de Uso de Agentes em Segundo Plano​

1. Análise de Base de Código​

[Segundo Plano] Varra toda a base de código e:
1. Encontre todos os comentários TODO
2. Identifique o uso de APIs obsoletas
3. Liste arquivos sem cobertura de testes
4. Detecte possíveis vazamentos de memória
5. Relate duplicação de código

Entregue um relatório resumido quando concluído.

2. Execução de Testes​

[Segundo Plano] Execute a suíte de testes completa:
1. Execute todos os testes unitários
2. Rode os testes de integração
3. Gere o relatório de cobertura
4. Salve os resultados em test-results/

Me notifique quando concluir com um resumo de passou/falhou.

3. Geração de Documentação​

[Segundo Plano] Gere documentação da API:
1. Varra src/ em busca de todas as funções/classes públicas
2. Crie JSDoc/docstrings onde estiverem faltando
3. Gere documentos markdown em docs/api/
4. Crie um índice de navegação

Use o estilo existente de src/utils/helpers.ts.

4. Refatoração de Grandes Bases de Código​

[Segundo Plano] Refatore o tratamento de erros:
1. Encontre todos os blocos try/catch
2. Padronize as mensagens de erro
3. Adicione logging de erros estruturado
4. Crie classes de erro personalizadas

Aplique as mudanças em toda a base de código.

Gerenciando Agentes em Segundo Plano​

Ver Agentes Ativos​

  1. Abra o painel Agentes em Segundo Plano:

    • Visualizar > Aparência > Mostrar Agentes em Segundo Plano
    • Ou use o ícone da barra lateral

  2. Veja todos os agentes em execução com:

    • Descrição da tarefa
    • Horário de início
    • Status atual
    • Indicador de progresso

Estados dos Agentes​

EstadoDescriçãoAção
ExecutandoO agente está trabalhando ativamenteMonitorar o progresso
PausadoO agente foi pausado manualmenteRetomar ou cancelar
ConcluídoA tarefa terminou com sucessoVer resultados
FalhouA tarefa encontrou um erroRevisar logs
CanceladoA tarefa foi interrompida pelo usuárioReiniciar se necessário

Controlando Agentes​

# Pausar um agente
cursor agent:pause <agent-id>

# Retomar um agente
cursor agent:resume <agent-id>

# Cancelar um agente
cursor agent:cancel <agent-id>

# Ver logs do agente
cursor agent:logs <agent-id>

Saída e Resultados do Agente​

Tipos de Resultado​

  1. Alterações de Arquivos: O agente modificou arquivos

    • Revisar no painel de Controle de Código Fonte
    • Ver diff antes de commitar

  2. Relatórios: Sumários gerados

    • Salvos no local especificado
    • Ou exibidos no painel de notificações

  3. Notificações: Atualizações de status

    • Notificações de desktop ao concluir
    • Badge no ícone do Cursor

Acessando Resultados​

Quando um agente em segundo plano conclui:

  1. Uma notificação aparece (se habilitada)
  2. Um badge aparece no dock/barra de tarefas do Cursor
  3. O painel de resultados abre automaticamente
  4. Arquivos alterados aparecem no Controle de Código Fonte

Boas Práticas​

Granularidade de Tarefas​

Divida tarefas grandes em agentes em segundo plano menores:

# Bom: Tarefas específicas e independentes
[Segundo Plano] Refatorar tratamento de erros do módulo de autenticação
[Segundo Plano] Refatorar tratamento de erros do módulo de pagamento
[Segundo Plano] Refatorar tratamento de erros do módulo de notificação

# Menos ideal: Uma tarefa gigante
[Segundo Plano] Refatorar todo o tratamento de erros em todo o aplicativo

Gerenciamento de Recursos​

Limite os agentes em segundo plano simultâneos:

# Máximo recomendado de agentes simultâneos
- 2-3 para tarefas intensivas em CPU (refatoração, análise)
- 5+ para tarefas vinculadas a E/S (documentação, relatórios)

Pontos de Verificação​

Para tarefas longas, use checkpoints:

[Segundo Plano] Migrar esquema do banco de dados:
1. Criar backup
2. Executar scripts de migração
3. Verificar integridade dos dados
4. Gerar script de rollback

Salvar progresso após cada etapa.
Se interrompido, retomar do último checkpoint.

Monitoramento e Logs​

Ver Logs do Agente​

  1. Abra o painel Agentes em Segundo Plano
  2. Clique em um agente concluído
  3. Veja o log de execução completo
  4. Veja timestamps e ações

Estrutura do Log​

[2026-06-25 10:00:00] Agente iniciado: "Varredura de segurança da base de código"
[2026-06-25 10:00:05] Lendo: src/auth/login.ts
[2026-06-25 10:00:10] Lendo: src/auth/register.ts
[2026-06-25 10:00:15] Análise concluída: 3 vulnerabilidades encontradas
[2026-06-25 10:00:20] Escrevendo relatório: security-report.md
[2026-06-25 10:00:25] Agente concluído com sucesso

Seleção de Modelo para Agentes em Segundo Plano​

Diferentes modelos se adequam a diferentes tarefas em segundo plano:

Tipo de TarefaModelo RecomendadoPor quê
Análise de códigoClaude 3.5 SonnetAprofundado, preciso
RefatoraçãoGPT-4oRápido, confiável
DocumentaçãoGemini 1.5 ProContexto longo
TestesClaude 3.5 SonnetBoa detecção de casos extremos
Auditoria de segurançaClaude 3 OpusAnálise profunda

Configure o modelo padrão nas Configurações:

{
  "backgroundAgents": {
    "defaultModel": "claude-3-5-sonnet",
    "maxConcurrent": 3,
    "autoNotify": true
  }
}

Solução de Problemas​

ProblemaSolução
O agente não iniciaVerifique os limites do plano; pode ser necessário fazer upgrade
O agente desapareceVerifique o painel de Agentes em Segundo Plano por erros
Resultados não salvosEspecifique o caminho de saída na descrição da tarefa
O agente travaCancele e reinicie; pode estar aguardando entrada
Alto uso de CPUReduza os agentes simultâneos; use modelos mais leves

Exemplo: Fluxo de Trabalho Completo em Segundo Plano​

# Manhã: Iniciar análise
[Segundo Plano] Analise a dívida técnica na base de código.
Gere uma lista priorizada de tarefas de refatoração.

# Enquanto o agente roda, continue codificando...

# Agente concluído
[Notificação] "Análise concluída: 12 oportunidades de refatoração encontradas"

# Revisar resultados
Abrir: analysis-results/refactoring-tasks.md

# Iniciar refatoração em segundo plano
[Segundo Plano] Implemente as 3 principais tarefas de refatoração da análise.

# Continuar outro trabalho...

# Revisar mudanças quando conveniente
Verificar o painel de Controle de Código Fonte para o diff

Recursos Relacionados​