Com a integração do Cursor com o Slack, você pode usar Background Agents para trabalhar nas suas tarefas diretamente a partir do Slack mencionando @Cursor com um prompt.

Primeiros passos

Instalação

  1. Acesse Cursor integrations
  2. Clique em Connect ao lado do Slack ou acesse a installation page a partir daqui
  3. Você será solicitado a instalar o app do Cursor para Slack no seu workspace.
  4. Após a instalação no Slack, você será redirecionado de volta ao Cursor para finalizar a configuração
    1. Conecte o GitHub (se ainda não estiver conectado) e escolha um repositório padrão
    2. Ative a cobrança baseada no uso
    3. Confirme as configurações de privacidade
  5. Comece a usar os Background Agents no Slack mencionando @Cursor

Como usar

Mencione @Cursor e forneça seu prompt. Isso resolve a maioria dos casos de uso, mas você também pode usar os comandos abaixo para personalizar seu agente. Por exemplo, mencione @Cursor fix the login bug diretamente na conversa, ou use comandos específicos como @Cursor [repo=torvalds/linux] fix bug para direcionar a um repositório específico.

Comandos

Execute @Cursor help para uma lista atualizada de comandos.
ComandoDescrição
@Cursor [prompt]Inicia um Background Agent. Em threads com agentes existentes, adiciona instruções de acompanhamento
@Cursor settingsConfigura padrões e repositório padrão do canal
@Cursor [options] [prompt]Usa opções avançadas: branch, model, repo
@Cursor agent [prompt]Força a criação de um novo agente em uma thread
@Cursor list my agentsMostra seus agentes em execução

Opções

Personalize o comportamento do Background Agent com essas opções:
OpçãoDescriçãoExemplo
branchEspecifica branch basebranch=main
modelEscolhe modelo de IAmodel=o3
repoDireciona a repositório específicorepo=owner/repo
autoprHabilita/desabilita criação automática de PRautopr=false
Formatos de Sintaxe
Use opções de várias maneiras:
  1. Formato de colchetes @Cursor [branch=dev, model=o3, repo=owner/repo, autopr=false] Fix the login bug
  2. Formato inline @Cursor branch=dev model=o3 repo=owner/repo autopr=false Fix the login bug
Precedência de opções
Ao combinar opções:
  • Valores explícitos sobrescrevem padrões
  • Valores posteriores sobrescrevem anteriores se duplicados
  • Opções inline têm precedência sobre padrões do modal de configurações
O bot analisa opções de qualquer lugar na mensagem, permitindo escrita natural de comandos.

Usando contexto de thread

Background Agents entendem e usam contexto de discussões existentes na thread. Útil quando sua equipe discute um problema e você quer que o agente implemente a solução baseada nessa conversa.
S
Sarah2:30 PM
Pessoal, estamos recebendo relatos de que usuários não conseguem fazer login após o último deploy
M
Mike2:32 PM
Verifiquei os logs - parece que a validação do token de auth está falhando na linha 247 do auth.js
A
Alex2:33 PM
Ah, acho que é porque mudamos o formato do token mas não atualizamos o regex de validação
S
Sarah2:35 PM
Sim, o regex ainda espera o formato antigo. Precisamos atualizá-lo para lidar com formatos antigos e novos para compatibilidade retroativa
Y
You2:36 PM
@Cursor fix this
1
Background Agents leem toda a thread para contexto quando invocados, entendendo e implementando soluções baseadas na discussão da equipe.

Quando usar comandos force

Quando preciso do @Cursor agent? Em threads com agentes existentes, @Cursor [prompt] adiciona instruções de acompanhamento (só funciona se você for dono do agente). Use @Cursor agent [prompt] para iniciar um agente separado. Quando preciso do Add follow-up (do menu de contexto)? Use o menu de contexto (⋯) na resposta de um agente para instruções de acompanhamento. Útil quando múltiplos agentes existem em uma thread e você precisa especificar qual seguir.

Atualizações de status e handoff

Quando o Background Agent executa, você primeiro recebe uma opção para Abrir no Cursor.
Quando o Background Agent termina, você recebe uma notificação no Slack e uma opção para visualizar o PR criado no GitHub.

Gerenciando agentes

Para ver todos os agentes em execução, execute @Cursor list my agents. Gerencie Background Agents usando o menu de contexto clicando nos três pontos (⋯) em qualquer mensagem do agente.
Opções disponíveis:
  • Add follow-up: Adicionar instruções a um agente existente
  • Delete: Parar e arquivar o Background Agent
  • View request ID: Visualizar ID único da solicitação para solução de problemas (inclua ao entrar em contato com o suporte)
  • Give feedback: Fornecer feedback sobre o desempenho do agente

Configuração

Gerencie configurações padrão e opções de privacidade no Dashboard → Background Agents.

Configurações

Modelo Padrão

Usado quando nenhum modelo é especificado explicitamente com @Cursor [model=...]. Veja as configurações para opções disponíveis.

Repositório Padrão

Usado quando nenhum repositório é especificado. Use estes formatos:
  • https://github.com/org/repository
  • org/repository
Se você referenciar um repositório que não existe, vai aparecer como se você não tivesse acesso. Isso aparece na mensagem de erro quando o Background Agent falha ao iniciar.

Branch Base

Branch inicial para o Background Agent. Deixe em branco para usar a branch padrão do repositório (geralmente main)

Configurações de Canal

Configure configurações padrão no nível do canal usando @Cursor settings. Essas configurações são por equipe e sobrescrevem seus padrões pessoais para aquele canal. Particularmente útil quando:
  • Canais diferentes trabalham em repositórios diferentes
  • Equipes querem configurações consistentes entre todos os membros
  • Você quer evitar especificar o repositório em cada comando
Para configurar as configurações do canal:
  1. Execute @Cursor settings no canal desejado
  2. Defina o repositório padrão para aquele canal
  3. Todos os membros da equipe usando Background Agents naquele canal usam esses padrões
Configurações de canal têm precedência sobre padrões pessoais, mas podem ser sobrescritas por opções explícitas como@Cursor [repo=...] [prompt]

Privacidade

Background Agents suportam Modo de Privacidade. Leia mais sobre Modo de Privacidade ou gerencie suas configurações de privacidade.
Modo de Privacidade (Legacy) não é suportado. Background Agents precisam de armazenamento temporário de código durante a execução.

Exibir Resumo do Agente

Exibe resumos do agente e imagens de diff. Pode conter caminhos de arquivo ou trechos de código. Pode ser ativado/desativado.

Exibir Resumo do Agente em Canais Externos

Para Slack Connect com outros workspaces ou canais com membros externos como Convidados, escolha exibir resumos do agente em canais externos.

Permissões

O Cursor solicita essas permissões do Slack para que os Background Agents funcionem no seu workspace:
PermissãoDescrição
app_mentions:readDetecta @menções para iniciar Background Agents e responder a solicitações
channels:historyLê mensagens anteriores em threads para contexto ao adicionar instruções de follow-up
channels:joinEntra automaticamente em canais públicos quando convidado ou solicitado
channels:readAcessa metadados do canal (IDs e nomes) para postar respostas e atualizações
chat:writeEnvia atualizações de status, notificações de conclusão e links de PR quando os agents finalizam
files:readBaixa arquivos compartilhados (logs, screenshots, samples de código) para contexto adicional
files:writeFaz upload de resumos visuais das alterações do agent para revisão rápida
groups:historyLê mensagens anteriores em canais privados para contexto em conversas multi-turn
groups:readAcessa metadados de canais privados para postar respostas e manter o fluxo da conversa
im:historyAcessa histórico de mensagens diretas para contexto em conversas contínuas
im:readLê metadados de DM para identificar participantes e manter o threading adequado
im:writeInicia mensagens diretas para notificações privadas ou comunicação individual
mpim:historyAcessa histórico de DM em grupo para conversas com múltiplos participantes
mpim:readLê metadados de DM em grupo para se dirigir aos participantes e garantir entrega adequada
reactions:readObserva reações de emoji para feedback do usuário e sinais de status
reactions:writeAdiciona reações de emoji para marcar status - ⏳ para executando, ✅ para concluído, ❌ para falhou
team:readIdentifica detalhes do workspace para separar instalações e aplicar configurações
users:readVincula usuários do Slack com contas do Cursor para permissões e acesso seguro