Slack

Trabalhe com Agentes em Segundo Plano no Slack

Com a integração do Cursor para o Slack, você pode usar os Agentes em Segundo Plano para trabalhar nas suas tarefas diretamente do Slack, mencionando @Cursor com um prompt.

Comece

Instalação

1. Vai em Cursor integrations

2. Clica em Connect ao lado do Slack ou acessa a installation page por aqui

3. Vai aparecer um prompt pra instalar o app do Cursor pro 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. Habilita a precificação baseada em uso
   3. Confirma as configurações de privacidade

5. Começa a usar os Background Agents no Slack mencionando @Cursor

Como usar

Menciona @Cursor e passa teu prompt. Isso cobre a maioria dos casos de uso, mas tu também pode usar os comandos abaixo pra personalizar teu agente.

Por exemplo, menciona @Cursor fix the login bug diretamente na conversa, ou usa comandos específicos como @Cursor [repo=torvalds/linux] fix bug pra direcionar um repositório em particular.

Comandos

Roda @Cursor help pra ver a lista de comandos atualizada.

Command	Description
@Cursor [prompt]	Inicia um Background Agent. Em threads com agentes existentes, adiciona instruções de acompanhamento
@Cursor settings	Configura 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 em uma thread
@Cursor list my agents	Mostra teus agentes em execução

Opções

Personaliza o comportamento do Background Agent com estas opções:

Option	Description	Example
branch	Define a branch base	branch=main
model	Escolhe o modelo de IA	model=o3
repo	Mira um repositório específico	repo=owner/repo
autopr	Ativa/desativa a criação automática de PR	autopr=false

Formatos de sintaxe

Usa 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 substituem os padrões
• Valores posteriores substituem os anteriores se duplicados
• Opções inline têm precedência sobre os padrões do modal de configurações

O bot analisa opções de qualquer parte da mensagem, permitindo escrever comandos de forma natural.

Usando o contexto da thread

Background Agents entendem e usam o contexto de discussões existentes na thread. Útil quando tua equipe discute 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 para obter contexto quando são acionados, entendendo e implementando soluções com base na discussão da equipe.

Quando usar comandos de força

Quando eu preciso de @Cursor agent?

Em threads com agentes existentes, @Cursor [prompt] adiciona instruções de acompanhamento (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 acompanhamento. Útil quando existem vários agentes em uma thread e tu precisa especificar em qual deles dar follow-up.

Atualizações de status e handoff

Quando o Background Agent roda, primeiro tu recebe a opção de Open in Cursor.

Quando o Background Agent termina, você recebe uma notificação no Slack e pode abrir o PR criado no GitHub.

Gerenciando agentes

Pra ver todos os agentes em execução, roda @Cursor list my agents.

Gerencia os Background Agents pelo 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: Interromper e arquivar o Background Agent
• View request ID: Ver o ID de solicitação exclusivo para troubleshooting (inclui ao falar com o suporte)
• Give feedback: Enviar feedback sobre o desempenho do agente

Configuração

Gerencia as configurações padrão e as 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. Use estes formatos:

• https://github.com/org/repository
• org/repository

Se um repositório inexistente for referenciado, vai parecer que não há acesso. Isso aparece na mensagem de erro quando o Background Agent falhar 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 do canal

Define configurações padrão no nível do canal usando @Cursor settings. Essas configurações são por equipe e substituem os padrões pessoais para aquele canal.

Particularmente útil quando:

• Canais diferentes trabalham em repositórios diferentes
• Times querem configurações consistentes para todos os membros
• Quer evitar especificar o repositório em todo 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 que utilizarem Background Agents naquele canal usarão 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

Os Background Agents oferecem suporte ao Modo de Privacidade.

Leia mais sobre o Modo de Privacidade ou gerencie as configurações de privacidade.

O Modo de Privacidade (legado) não é suportado. Os Background Agents exigem 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 arquivos 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, é possível escolher exibir resumos do agente em canais externos.

Permissões

O Cursor solicita estas permissões do Slack para os Background Agents funcionarem no teu workspace:

Permissão	Descrição
app_mentions:read	Detecta @mentions para iniciar Background Agents e responder às solicitações
channels:history	Lê mensagens anteriores em threads para dar contexto ao adicionar instruções de acompanhamento
channels:join	Entra automaticamente em canais públicos quando convidado ou solicitado
channels:read	Acessa metadados dos canais (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 finalizam
files:read	Baixa arquivos compartilhados (logs, capturas de tela, trechos de código) para contexto adicional
files:write	Faz upload de resumos visuais das alterações dos agents para revisão rápida
groups:history	Lê mensagens anteriores em canais privados para contexto em conversas de múltiplas etapas
groups:read	Acessa metadados de canais privados para postar respostas e manter o fluxo da conversa
im:history	Acessa o histórico de mensagens diretas para contexto em conversas contínuas
im:read	Lê metadados de DMs para identificar participantes e manter o encadeamento correto
im:write	Inicia mensagens diretas para notificações privadas ou comunicação individual
mpim:history	Acessa o histórico de DMs em grupo para conversas com múltiplos participantes
mpim:read	Lê metadados de DMs em grupo para direcionar participantes e garantir a entrega correta
reactions:read	Observa reações com emoji para feedback de usuários e sinais de status
reactions:write	Adiciona reações com emoji para marcar status — ⏳ em execução, ✅ concluído, ❌ com falha
team:read	Identifica detalhes do workspace para separar instalações e aplicar configurações
users:read	Faz o mapeamento entre usuários do Slack e contas do Cursor para permissões e acesso seguro