Com a integração do Cursor para Slack, você pode usar Background Agents para trabalhar em suas tarefas diretamente do Slack mencionando @Cursor com um prompt.
Começar
Instalação
-
Vá para Integrações do Cursor
-
Clique em Conectar ao lado do Slack ou vá para a página de instalação a partir daqui
-
Você será solicitado a instalar o aplicativo Cursor para Slack em seu workspace.
-
Após instalar no Slack, você será redirecionado de volta ao Cursor para finalizar a configuração
- Conecte o GitHub (se ainda não estiver conectado) e escolha um repositório padrão
- Habilite o preço baseado em uso
- Confirme as configurações de privacidade
-
Comece a usar Background Agents no Slack mencionando @Cursor
Como usar
Mencione @Cursor e forneça seu prompt. Isso atende à 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.
| Comando | Descrição | |:--------|:------------| |
@Cursor [prompt] | Inicia um Background Agent.
Em threads com agentes existentes, adiciona instruções de acompanhamento | |
@Cursor settings | Configura 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 agents
| Mostra seus agentes em execução |
Opções
Personalize o comportamento do Background Agent com essas opções:
| Opção | Descrição | Exemplo | |:-------|:------------|:--------| |
branch
| Especifica branch base | branch=main
| | model
| Escolhe modelo de IA |
model=o3
| | repo
| Direciona repositório específico | repo=owner/repo
| |
autopr
| Habilita/desabilita criação automática de PR | autopr=false
|
Formatos de Sintaxe
Use opções de várias maneiras:
-
Formato de colchetes
@Cursor [branch=dev, model=o3, repo=owner/repo, autopr=false] Fix the login bug
-
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 os 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 autenticação 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 com versões anteriores
Y
You2:36 PM
@Cursor fix this
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 o dono do agente). Use @Cursor agent [prompt] para lançar 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 deles acompanhar.
Atualizações de status e transferência
Quando o Background Agent executa, você primeiro recebe uma opção para Abrir no Cursor.
Quando o Background Agent é concluído, 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 (incluir 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 em Dashboard → Background Agents.
Configurações
Modelo Padrão
Usado quando nenhum modelo é especificado explicitamente com @Cursor [model=...]. Veja 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 inexistente, aparecerá como se você não tivesse
acesso. Isso é mostrado 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 (frequentemente 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 esse canal.
Particularmente útil quando:
- Diferentes canais 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:
- Execute @Cursor settings no canal desejado
- Defina o repositório padrão para esse canal
- Todos os membros da equipe usando Background Agents nesse 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 requerem
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 ligado/desligado.
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 dentro do seu workspace:
| Permissão | Descrição | |:-----------|:------------| |
app_mentions:read
| Detecta @menções para iniciar Background Agents e responder
a solicitações | | channels:history
| Lê mensagens anteriores em threads para
contexto ao adicionar instruções de acompanhamento | | channels:join
| Entra automaticamente
em canais públicos quando convidado ou solicitado | | channels:read
| Acessa
metadados do canal (IDs e nomes) para postar respostas e atualizações | | chat:write
| Envia atualizações de status, notificações de conclusão e links de PR quando os agents
terminam | | files:read
| Baixa arquivos compartilhados (logs, capturas de tela, amostras de código
) para contexto adicional | | files:write
| Faz upload de resumos visuais
das alterações do agent para revisão rápida | | groups:history
| Lê mensagens anteriores
em canais privados para contexto em conversas de múltiplas interações | |
groups:read
| Acessa metadados de canais privados para postar respostas e
manter o fluxo da conversa | | im:history
| Acessa histórico de mensagens diretas
para contexto em conversas continuadas | | im:read
| Lê metadados de DM para
identificar participantes e manter o encadeamento adequado | | im:write
| Inicia
mensagens diretas para notificações privadas ou comunicação individual | |
mpim:history
| Acessa histórico de DM em grupo para conversas com múltiplos participantes
| | mpim:read
| Lê metadados de DM em grupo para se dirigir aos participantes e garantir
entrega adequada | | reactions:read
| Observa reações de emoji para feedback do usuário
e sinais de status | | reactions:write
| Adiciona reações de emoji para
marcar status - ⏳ para executando, ✅ para concluído, ❌ para falhou | | team:read
| Identifica detalhes do workspace para separar instalações e aplicar configurações |
| users:read
| Combina usuários do Slack com contas do Cursor para permissões e
acesso seguro |