Implante o Grok Bot na sua organização

Sua equipe de TI instala o app desktop do Grok Bot nos dispositivos dos membros usando as mesmas ferramentas que já usa para outros softwares: baixar um instalador versionado, distribuí-lo e decidir quando os dispositivos passam para uma nova versão. Os controles do dashboard para ativar o Grok Bot e definir o escopo de acesso estão em Grok Bot para Teams e Enterprise, e a implantação do Editor Cherri Code é abordada em Padrões de implantação.

O que você implanta

Os apps são clientes para chat, revisão e aprovações. Os Bots trabalham no hosted computer do membro. Sua ferramenta de gerenciamento de dispositivos chega até os apps nos dispositivos dos membros e para aí: o hosted computer roda Linux na nuvem da Cherri Code e não é registrado no MDM. Para instalar suas próprias ferramentas nos hosted computers, equipes Enterprise usam o Team Setup.

Obtenha os instaladores

• Dashboard do Cherri Code. Na página do Grok Bot, a linha de configuração Download Grok Bot instala o app ou copia um link que você pode compartilhar com os membros.
• Página de download. cursor.com/download/bot lista o instalador atual para cada plataforma e formato.
• Feed de releases. Para empacotamento via script, leia a release atual no feed abaixo e baixe o arquivo indicado nela.

Consulte a versão atual no feed

Cada plataforma tem um feed JSON em #:

curl -s #

Os campos de que você precisa:

A resposta pode trazer outros campos, mas eles não são necessários para instalar o app desktop.

Monte uma URL com versão

Os instaladores para macOS e Windows mantêm uma URL com versão para cada release. Substitua {version} pela release desejada:

Os pacotes para Linux ficam no commitSha da release, em https://downloads.cursor.com/grokbot/stable/{commitSha}/linux/x64/ ou .../linux/arm64/. Copie as URLs exatas dos arquivos de downloadUrl, debUrl e rpmUrl no feed do Linux.

Distribua o app desktop com sua ferramenta de gerenciamento de dispositivos

• macOS. Implante o .dmg com a ferramenta de gerenciamento de Mac que você já usa, como Jamf Pro, Kandji ou Microsoft Intune.
• Windows. Implante o .exe de instalação com o Intune, o Configuration Manager ou outra ferramenta de distribuição de software. Instale em modo silencioso com Grok_Bot_{version}_Setup.exe /S. O instalador faz a instalação por usuário, no perfil do membro em %LOCALAPPDATA%\Programs, então implante-o no contexto do usuário, e não como SYSTEM. Teste a instalação em um dispositivo piloto antes de distribuí-lo.
• Linux. Instale o .deb ou o .rpm com sua ferramenta de gerenciamento de configuração, como Ansible, Puppet ou Chef. Prefira esses pacotes para pools de workers gerenciados: instalações via pacote são atualizadas pelo seu gerenciador de pacotes, no cronograma que você definir. Veja Atualizações de pacotes no Linux.
• iPhone. Os membros instalam o Grok Bot pela App Store no iOS 18 ou posterior.
• Android. Os membros instalam o Grok Bot pelo Google Play no Android 9 ou posterior. Para distribuí-lo em dispositivos gerenciados, aprove-o no Google Play gerenciado usando o Intune ou outra ferramenta de gerenciamento de dispositivos Android.

Os membros fazem login com a conta do Cherri Code pelo fluxo de SSO habitual da sua organização. O Grok Bot não tem login próprio. Para atribuir o app Cherri Code no Okta ou no Entra ID, veja Configurar identidade e acesso.

Escolha uma versão

• Fixe a versão que você testou. Baixe o instalador desse release e guarde-o no seu próprio repositório de software ou no store de pacotes do MDM. Faça a implantação a partir da sua cópia para que todo dispositivo novo receba o mesmo build. O Cherri Code não informa por quanto tempo os instaladores antigos ficam disponíveis para download, e um build fixado só funciona enquanto o Cherri Code oferecer suporte a ele. Veja Como funcionam as atualizações do app desktop.
• Salve a URL completa do Linux. As URLs dos pacotes para Linux incluem o commitSha do release, então registre a URL junto com a versão.
• Verifique qual versão um dispositivo está executando. No app, abra o menu da conta e escolha About. A caixa de diálogo mostra Version, e Copy version info copia a versão, o canal de release e o sistema operacional.

Como funcionam as atualizações do app desktop

Em instalações no macOS, no Windows e via AppImage, nenhuma política de dispositivo, opção do instalador ou configuração do dashboard desativa as atualizações do app desktop. Fixar uma versão define qual versão você instala, mas o app continua oferecendo versões mais recentes depois disso.

Builds antigos param de funcionar. Quando o Cherri Code deixa de oferecer suporte a um build, o app cobre toda a janela com Update required até que o membro faça a atualização. Um build perde o suporte quando fica abaixo da versão mínima exigida pelo Cherri Code ou quando ultrapassa uma idade máxima e já há um release mais recente disponível. Isso vale para todas as instalações, incluindo pacotes Linux .deb e .rpm. O Cherri Code define os dois limites remotamente e não os divulga, então defina uma rotina regular para migrar os dispositivos para o release atual.

Atualizações de pacotes no Linux

Ao instalar o .deb, o repositório apt assinado do Cherri Code é adicionado em /etc/apt/sources.list.d/grok-bot.sources. Ao instalar o .rpm, um repositório assinado é adicionado em /etc/yum.repos.d/grok-bot.repo. A partir daí, os dispositivos recebem novas versões do Grok Bot sempre que executam atualizações de pacotes.

Para controlar quando os dispositivos Linux são atualizados:

• Congele o pacote. Use o recurso de hold do seu gerenciador de pacotes, como apt-mark hold grok-bot, e libere-o quando estiver pronto para atualizar.
• Desative o repositório. Defina Enabled: no em grok-bot.sources ou enabled=0 em grok-bot.repo. O pacote reescreve esses arquivos a cada instalação e atualização, mas preserva sua escolha. Depois, distribua você mesmo as novas versões a partir de arquivos de pacote já testados.

Em qualquer um dos casos, atualize antes que a versão instalada deixe de ter suporte. Mesmo com o pacote congelado, a tela Update required continua sendo exibida.

Atualizar os hosted computers

O Cherri Code mantém a imagem do hosted computer, então você não precisa fixar nem fornecer nenhuma imagem. Um computador passa para uma imagem mais recente de uma destas três formas:

Computadores em execução recebem as alterações do manifesto do Team Setup cerca de uma vez por dia. Para aplicar uma alteração mais cedo, recrie os computadores. No Enterprise, os logs de auditoria registram atualizações, redefinições, recriações e encerramentos de computadores como eventos grok_bot_vm, e operações envolvendo vários membros como grok_bot_vm_bulk.

Libere o acesso à rede

Os dispositivos baixam instaladores e atualizações do app desktop de cursor.com e downloads.cursor.com, e o app se conecta à API do Cherri Code e ao hosted computer do membro pelos domínios listados em Permita estes padrões de domínio. Libere todos eles, incluindo o padrão aninhado *.*.cursorvm.com, e isente-os da inspeção TLS antes de distribuir o app.

Checklist de liberação

Perguntas frequentes

Páginas relacionadas

• Grok Bot para Teams e Enterprise
• Configurar identidade e acesso
• Configurar proxies com inspeção TLS
• Manage Grok Bot computers
• Configurações e notificações
• Padrões de implantação