Pular para o conteúdo principal
Com a integração do Cursor com o Slack, você pode usar os Background Agents pra trabalhar nas suas tarefas direto no Slack, mencionando @Cursor com um prompt.

Comece

Instalação

  1. Vai em Cursor integrations
  2. Clica em Connect ao lado do Slack ou vai pra installation page daqui
  3. Vai aparecer um prompt pra instalar o app do Cursor para Slack no teu workspace.
  4. Depois de instalar no Slack, tu vai ser redirecionado de volta pro Cursor pra finalizar a configuração
    1. Conecta o GitHub (se ainda não estiver conectado) e escolhe um repositório padrão
    2. Ativa a cobrança por uso
    3. Confirma as configurações de privacidade
  5. Começa a usar Background Agents no Slack mencionando @Cursor

Como usar

Menciona @Cursor e manda teu prompt. Isso cobre a maioria dos casos de uso, mas também dá pra usar os comandos abaixo pra personalizar teu agente. Por exemplo, menciona @Cursor fix the login bug direto na conversa, ou usa comandos específicos como @Cursor [repo=torvalds/linux] fix bug pra direcionar um repositório específico.

Comandos

Roda @Cursor help pra ver a lista de comandos atualizada.
CommandDescription
@Cursor [prompt]Inicia um Background Agent. Em threads com agentes existentes, adiciona instruções de follow-up
@Cursor settingsConfigura padrões e o 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 na thread
@Cursor list my agentsMostra teus agentes em execução

Opções

Personaliza o comportamento do Background Agent com estas opções:
OptionDescriptionExample
branchDefine a branch basebranch=main
modelEscolhe o modelo de IAmodel=o3
repoDefine um repositório específico como alvorepo=owner/repo
autoprAtiva/desativa a criação automática de PRautopr=false
Formatos de sintaxe
Dá pra usar as opções de várias formas:
  1. Formato com 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 das opções
Ao combinar opções:
  • Valores explícitos sobrescrevem os padrões
  • Valores mais recentes sobrescrevem os anteriores se repetidos
  • Opções inline têm precedência sobre os padrões do modal de settings
O bot interpreta as opções de qualquer lugar da mensagem, permitindo escrever comandos de forma natural.

Usando o contexto da thread

Background Agents entendem e usam o contexto das discussões existentes na thread. Útil quando teu time tá discutindo um problema e tu quer que o agente implemente a solução com base nessa conversa.
S
Sarah2:30 PM
Hey team, we're getting reports that users can't log in after the latest deploy
M
Mike2:32 PM
I checked the logs - looks like the auth token validation is failing on line 247 of auth.js
A
Alex2:33 PM
Oh, I think it's because we changed the token format but didn't update the validation regex
S
Sarah2:35 PM
Yeah, the regex still expects the old format. We need to update it to handle both old and new formats for backwards compatibility
Y
You2:36 PM
@Cursor fix this
1
Background Agents leem a thread inteira pra obter contexto quando são invocados, entendendo e implementando soluções com base na discussão do time.

Quando usar comandos de força

Quando eu preciso de @Cursor agent? Em threads com agentes existentes, @Cursor [prompt] adiciona instruções de follow-up (só funciona se tu for o dono do agente). Usa @Cursor agent [prompt] pra iniciar um agente separado. Quando eu preciso de Add follow-up (no menu de contexto)? Usa o menu de contexto (⋯) na resposta de um agente pra instruções de follow-up. Útil quando existem vários agentes numa thread e tu precisa especificar em qual deles dar follow-up.

Atualizações de status e handoff

Quando o Background Agent roda, tu primeiro recebe a opção de Open in Cursor.
Quando o Background Agent terminar, tu recebes uma notificação no Slack e uma opção pra ver o PR criado no GitHub.

Gerenciando agents

Pra ver todos os agents em execução, roda @Cursor list my agents. Gerencia os Background Agents usando o menu de contexto clicando nos três pontos (⋯) em qualquer mensagem do agent.
Opções disponíveis:
  • Add follow-up: Adiciona instruções a um agent existente
  • Delete: Interrompe e arquiva o Background Agent
  • View request ID: Exibe o ID de requisição exclusivo para troubleshooting (inclui ao falar com o suporte)
  • Give feedback: Envia feedback sobre a performance do agent

Configuração

Gerencia padrões e opções de privacidade em 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. Usa estes formatos:
  • https://github.com/org/repository
  • org/repository
Se você referenciar um repositório inexistente, vai parecer que não tem acesso. Isso aparece na mensagem de erro quando o Background Agent falha ao iniciar.

Branch base

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

Configurações do canal

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

Privacidade

Background Agents têm suporte ao Privacy Mode. Lê mais sobre o Privacy Mode ou gerencia suas configurações de privacidade.
Privacy Mode (Legacy) não é compatível. Background Agents exigem armazenamento temporário de código enquanto estão em execução.

Exibir resumo do agente

Exibe resumos do agente e imagens de diff. Pode conter caminhos de arquivos ou trechos de código. Pode ser ligado/desligado.

Exibir resumo do agente em canais externos

Para Slack Connect com outras workspaces ou canais com membros externos, como convidados, escolhe exibir resumos do agente em canais externos.

Permissões

O Cursor solicita estas permissões do Slack para que os Background Agents funcionem no teu workspace:
PermissãoDescrição
app_mentions:readDetecta menções com @ para iniciar os Background Agents e responder às solicitações
channels:historyLê mensagens anteriores em threads para contexto ao adicionar instruções de acompanhamento
channels:joinEntra automaticamente em canais públicos quando convidado ou quando solicitado
channels:readAcessa metadados dos canais (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 agentes terminam
files:readBaixa arquivos compartilhados (logs, capturas de tela, exemplos de código) para contexto adicional
files:writeEnvia resumos visuais das alterações feitas pelos agentes para revisão rápida
groups:historyLê mensagens anteriores em canais privados para contexto em conversas de múltiplas interações
groups:readAcessa metadados de canais privados para postar respostas e manter o fluxo da conversa
im:historyAcessa o histórico de mensagens diretas para contexto em conversas contínuas
im:readLê metadados de DMs para identificar participantes e manter o encadeamento correto
im:writeInicia mensagens diretas para notificações privadas ou comunicação individual
mpim:historyAcessa o histórico de DMs em grupo para conversas com vários participantes
mpim:readLê metadados de DMs em grupo para direcionar participantes e garantir a entrega correta
reactions:readObserva reações com emoji para feedback do usuário e sinais de status
reactions:writeAdiciona reações com emoji para marcar status — ⏳ em execução, ✅ concluído, ❌ com falha
team:readIdentifica detalhes do workspace para separar instalações e aplicar configurações
users:readFaz a correspondência de usuários do Slack com contas do Cursor para permissões e acesso seguro
I