Slack

Com a integração do Cherri Code ao Slack, você pode usar agentes na nuvem para trabalhar em suas tarefas diretamente no Slack, mencionando @cursor com um prompt.

Introdução

Instalação

1. Acesse as integrações do Cherri Code

2. Clique em Conectar ao lado do Slack ou acesse a página de instalação

3. Você será solicitado a instalar o app Cherri Code para Slack no seu espaço de trabalho.

4. Após instalar o app no Slack, você será redirecionado ao Cherri Code para concluir a configuração

   1. Conecte um provedor de repositórios (caso ainda não esteja conectado) e escolha um repositório padrão
   2. Ative a precificação baseada em uso
   3. Confirme as configurações de privacidade

5. Comece a usar agentes na nuvem no Slack mencionando @cursor

Como usar

Mencione @cursor e escreva seu prompt. O Cherri Code tenta identificar, com base na sua mensagem, um repositório, modelo, branch base ou ambiente de agente em nuvem nomeado. Ele também usa a atividade recente dos seus agentes ao selecionar um repositório.

Para um ambiente nomeado, inclua o nome dele no seu prompt. Por exemplo: @Cherri Code use the Platform environment to update the shared API.

Comandos

Execute @Cherri Code help para ver a lista de comandos atualizada.

Opções

Personalize o comportamento do agente em nuvem com estas opções:

Formatos de sintaxe

Natural:

@Cherri Code with opus, fix the login bug in backend-api

Inline:

@Cherri Code env=Platform branch=dev model=opus autopr=false Fix the login bug

Use aspas em nomes de ambiente com espaços:

@Cherri Code env="Platform Services" Update the shared API

Precedência de opções

Ao combinar opções:

• Valores explícitos substituem os valores padrão
• Valores posteriores substituem os anteriores em caso de duplicação
• Opções inline têm precedência sobre os valores padrão do modal de configurações
• env tem precedência sobre repo quando ambos estão presentes
• pool, worker, machine e self_hosted=false (ou sh=0) têm precedência sobre o pool padrão do canal e o pool padrão da equipe

O bot identifica opções em qualquer parte da mensagem, permitindo escrever comandos naturalmente.

O Cherri Code ignora opções key=value dentro de blocos de código com crases triplas, mesmo em blocos de uma única linha, e mantém o código no seu prompt exatamente como foi escrito. Nesta mensagem, pool=None está dentro do bloco de código, então nenhum pool é selecionado:

@Cherri Code why does this crash? ```engine = create_engine(db_url, pool=None)```

Como usar o contexto da thread

Os agentes na nuvem entendem e usam o contexto de discussões em threads existentes. É útil quando sua equipe discute uma issue e você quer que o agente implemente a solução com base nessa thread.

Quando usar comandos de força

Quando preciso usar @Cherri Code agent?

Em threads com agentes existentes, @Cherri Code [prompt] adiciona instruções de acompanhamento. Quem pode enviar instruções de acompanhamento é definido em Mensagens de acompanhamento da equipe. Se as mensagens de acompanhamento da equipe estiverem desativadas, apenas o proprietário poderá enviar instruções de acompanhamento. Para iniciar um agente separado, use @Cherri Code agent [prompt] ou faça o pedido em linguagem natural:

@Cherri Code start a new agent to refactor billing

Frases como "criar um novo agente", "iniciar um novo agente" ou "novo agente, por favor" funcionam da mesma forma.

Quando preciso usar Add follow-up (no menu de contexto)?

Use o menu de contexto (⋯) na resposta de um agente para enviar instruções de acompanhamento. Isso é útil quando há vários agentes em uma thread e você precisa especificar qual deles deve receber a instrução.

Atualizações de status e transferência

Antes de começar a alterar o código, o Cherri Code publica um plano curto na thread quando você está corrigindo um bug ou quando os detalhes de implementação ajudam a acompanhar o trabalho. Solicitações simples não recebem essa nota. Enquanto trabalha, o Cherri Code atualiza um status curto abaixo da thread.

Quando o agente em nuvem é executado, você recebe primeiro a opção de Abrir no Cherri Code.

Quando o agente em nuvem é concluído, você recebe uma notificação no Slack e a opção de ver a PR criada no GitHub.

Gerenciar agentes

Para ver todos os agentes em execução, execute @Cherri Code list my agents.

Gerencie os agentes em nuvem pelo menu de contexto, clicando nos três pontos (⋯) em qualquer mensagem de agente.

Opções disponíveis:

• Add follow-up: adicione instruções a um agente existente
• Switch repository: execute novamente a mesma solicitação em outro repositório ou ambiente de agente em nuvem
• Excluir: interrompa e arquive o agente em nuvem
• Ver ID da solicitação: veja o ID exclusivo da solicitação para solução de problemas (inclua-o ao entrar em contato com o suporte)
• Enviar feedback: envie feedback sobre o desempenho do agente

Se o agente precisar de um repositório ou ambiente diferente do atual, o Slack também mostra Switch repository na mensagem de início. Escolha o novo destino e o Cherri Code continua a partir dali.

Configuração

Gerencie as configurações padrão e as opções de privacidade em Dashboard → Cloud Agents.

Configurações

Modelo padrão

Usado quando nenhum modelo é especificado na mensagem. Consulte as configurações para conferir as opções disponíveis.

Seleção de repositório

O Cherri Code seleciona automaticamente o repositório adequado com base em:

1. Conteúdo da sua mensagem — Nomes de repositórios ou palavras-chave no prompt
2. Atividade recente do agente — Repositórios que você usou recentemente
3. Regras de roteamento — Mapeamentos personalizados de palavras-chave para repositórios (veja abaixo)
4. Repositório padrão — Alternativa quando não há correspondência

Para usar um repositório específico, inclua o nome dele na mensagem. Por exemplo: @Cherri Code in mobile-app, fix the login bug.

Branch base

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

Configurações do canal

Configure as configurações padrão no nível do canal usando @Cherri Code settings. Essas configurações são específicas da equipe e substituem suas configurações pessoais padrão nesse canal.

Particularmente útil quando:

• Diferentes canais trabalham em repositórios diferentes
• As equipes querem configurações consistentes para todos os membros

Para configurar as configurações do canal:

1. Execute @Cherri Code settings no canal desejado
2. Defina o repositório padrão desse canal
3. Todos os membros da equipe que usam agentes na nuvem nesse canal usam essas configurações padrão

Regras de roteamento

As regras de roteamento permitem definir palavras-chave associadas automaticamente a um destino. Quando sua mensagem contém uma palavra-chave, o Cherri Code roteia o agente para o repositório associado ou o ambiente de agente em nuvem. Os ambientes podem agrupar vários repositórios, de modo que uma única palavra-chave pode iniciar um agente com todos os repositórios de que ele precisa já configurados.

Configurar regras de roteamento

1. Acesse Dashboard → Cloud Agents
2. Localize a seção Regras de roteamento
3. Adicione mapeamentos de palavras-chave para destinos, associando cada palavra-chave a um repositório ou ambiente

Regras de exemplo

Com essas regras configuradas:

• @Cherri Code fix the frontend nav bug → é roteado para acme/web-app
• @Cherri Code update the mobile onboarding flow → é roteado para acme/mobile-app
• @Cherri Code add a migration across the platform → inicia no ambiente Platform, com todos os repositórios prontos

Como funciona o roteamento

O Cherri Code avalia sua mensagem nesta ordem:

1. Conteúdo da sua mensagem — Nomes de repositórios ou palavras-chave no prompt
2. Atividade recente do agente — Repositórios que você usou recentemente
3. Regras de roteamento — Mapeamentos personalizados de palavras-chave para destinos (repositório ou ambiente)
4. Padrão do canal — O repositório definido para este canal
5. Repositório padrão — Usado quando nenhuma correspondência é encontrada

Pool padrão da equipe

Os Admin da equipe podem definir um Pool da equipe como padrão para as execuções via @Cherri Code. Assim, os membros passam a rodar nesse pool sem precisar adicionar pool=<name> ou self_hosted=true em cada menção. O padrão vale para toda a equipe, em todos os canais que não tenham um pool padrão do canal.

Gerencie o padrão pelo Slack. Definir ou limpar essa opção exige a mesma permissão necessária para alterar as configurações de Self-Hosted no dashboard. Qualquer pessoa pode visualizá-la.

@Cherri Code pool set my-pool@Cherri Code pool@Cherri Code pool unset

@Cherri Code settings também lista o pool padrão da equipe.

Pool padrão do canal

Admins da equipe também podem atribuir um pool próprio a um canal. As menções a @Cherri Code nesse canal passam a ser executadas no pool do canal em vez do padrão da equipe, e os demais canais continuam usando o padrão da equipe. Definir ou remover essa configuração exige a mesma permissão que o padrão da equipe.

Execute estes comandos no canal que você quer alterar:

@Cherri Code pool set my-pool channel@Cherri Code pool@Cherri Code pool unset channel

@Cherri Code pool mostra o pool do canal ao lado do padrão da equipe. Para escolher a partir de uma lista, execute @Cherri Code settings, clique em Set Pool for Channel e escolha um dos pools da sua equipe. Para removê-lo, escolha Use the team default (no channel pool). Depois disso, as menções no canal voltam a usar o padrão da equipe.

Como o Cherri Code define onde uma menção é executada

As opções na sua mensagem sempre prevalecem. O Cherri Code resolve o destino nesta ordem:

1. Opções na sua mensagem. pool=<name> direciona para esse pool. worker= ou machine= direciona para uma das suas My Machines. self_hosted=false (ou sh=0) executa na infraestrutura gerenciada do Cherri Code. Cada uma dessas opções ignora os dois pools padrão. Um self_hosted=true (ou sh=1) sem outras opções usa o pool padrão do canal ou, se o canal não tiver um, o pool padrão da equipe.
2. Seu worker padrão do My Machines. Se você tiver um worker padrão próprio para o repositório, ele tem precedência sobre os dois pools padrão.
3. Pool padrão do canal. Usado quando o canal em que você menciona o Cherri Code tem um pool próprio.
4. Pool padrão da equipe. Usado quando sua mensagem não traz nenhuma das opções acima e o canal não tem um pool próprio.

Repositórios e pools padrão

A seleção de repositório funciona da mesma forma com um pool padrão do canal ou da equipe: conteúdo da mensagem, atividade recente, regras de roteamento, padrão do canal e, por fim, seu repositório padrão e o da equipe. O que acontece em seguida depende de como o pool foi registrado:

• Pool any repo, nenhum repositório resolvido. O Slack inicia um agente no pool sem repositório. O source control fica a cargo do worker, como em qualquer any-repo pool. Se um repositório padrão for resolvido, o agente o recebe como contexto, sem limitar quais workers podem reivindicar a execução.
• Pool vinculado a repositório, nenhum repositório resolvido. O Slack rejeita a menção com uma resposta efêmera, em vez de recorrer à infraestrutura gerenciada. Adicione repo= ou pool= à menção, use self_hosted=false para executar em infraestrutura gerenciada ou verifique o padrão com @Cherri Code pool e @Cherri Code settings.
• Repositório resolvido e o pool o atende. O Slack inicia com repo= e pool= definidos, como em uma menção explícita pool=<name>.
• Repositório resolvido, mas os workers do pool atendem apenas outros repositórios. O Slack rejeita a menção com uma resposta efêmera. Escolha um repositório atendido pelo pool com repo= ou um pool que atenda a este repositório com pool=.

Privacidade

Os agentes na nuvem são compatíveis com o Privacy Mode.

Saiba mais sobre o Privacy Mode ou gerencie suas configurações de privacidade.

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 ou desativado.

Exibir resumo do agente em canais externos

No Slack Connect com outros espaços de trabalho ou em canais com membros externos, como convidados, escolha exibir resumos dos agentes em canais externos.

Permissões

O Cherri Code solicita estas permissões do Slack para que os agentes na nuvem funcionem no seu espaço de trabalho:

Aviso

O Cherri Code pode cometer erros. Revise o código e as respostas.

Política de Privacidade

Para saber como o Cherri Code coleta, usa e protege seus dados, consulte nossa Política de Privacidade.