Grok Bot para Teams e Enterprise

O Grok Bot oferece a cada pessoa da sua equipe Bots permanentes para o dia a dia: pesquisa, operações, documentos, navegação e automações. Esta página é destinada a admins de equipes e organizações que estão implantando o Grok Bot. Revisores de segurança devem começar por Segurança do Grok Bot e pelo FAQ de segurança do Grok Bot. Membros que querem entender o modelo de aprovação também devem começar por ali.

Disponibilidade

Essa tabela mostra o acesso ao produto, não a lista de controles de administração. O Grok Bot está incluído no Teams. Algumas configurações são somente para Enterprise e não aparecem para Teams self-serve. Controles de administração identifica cada uma delas.

Planos e faturamento é a matriz oficial de planos e uso.

Ativar o Grok Bot para sua equipe

No plano Teams, o Grok Bot vem habilitado por padrão e todos os membros têm acesso sem nenhuma ação do admin. Ele permanece desativado para equipes em Privacy Mode (Legacy) ou em um plano legado baseado em solicitações. Não há opção para desativá-lo.

No plano Enterprise, um admin o ativa em Grok Bot no dashboard do Cherri Code. Depois de habilitado, você pode liberar o acesso para todos os membros da equipe ou limitá-lo a grupos específicos com "Gerenciar acesso de grupos". Desativar o Grok Bot bloqueia todos os membros sem excluir seus computadores.

Admins de qualquer um dos planos podem adicionar membros com "Invite Team" na página do Grok Bot. Usuários do Cherri Code que já estão na sua equipe recebem um email com um link de download. Novos usuários recebem um convite para sua equipe do Cherri Code, por email ou link de convite, que também os direciona ao Grok Bot. Equipes que gerenciam a associação por SCIM veem apenas a opção de usuários existentes.

Para você mesmo instalar o app desktop em dispositivos gerenciados e planejar as atualizações, consulte Implantar o Grok Bot na sua organização.

Antes da implementação

• Desative o Privacy Mode (Legacy). Essa configuração bloqueia completamente o Grok Bot, e será solicitado que você a altere antes de ativá-lo. Verifique a configuração de privacidade nas Configurações da equipe.
• Planeje o uso de endereços de saída compartilhados. Se sua empresa restringe serviços por IP de origem, consulte IPs de saída estáticos.
• Libere seu gateway. Se os dispositivos dos membros estiverem atrás do Zscaler ou de outro proxy com inspeção de TLS, permita os domínios da Cherri Code, incluindo o padrão aninhado *.*.cursorvm.com, e isente-os da inspeção antes que os membros se conectem. Consulte Configurar proxies com inspeção TLS.
• Defina como os membros farão login nas ferramentas da empresa a partir do computador. Consulte identidade e login.
• Revise as políticas herdadas pelo Grok Bot: as Regras da equipe e a política de conectores em todos os planos, além das regras de Auto-review da equipe e da lista de permissão de MCP no Enterprise.

Arquitetura

Como o Grok Bot é estruturado

O Grok Bot é um agente que opera aplicativos, navegadores e ambientes de desenvolvimento. Ele é executado na nuvem do Cherri Code, e o trabalho de cada usuário é realizado em um computador na nuvem dedicado. Os apps para desktop e dispositivos móveis são clientes leves para chat, revisão e aprovações.

O modelo de segurança se baseia em quatro princípios:

• Isolamento por usuário. O trabalho de cada usuário é executado em uma microVM Firecracker dedicada, uma micromáquina virtual com separação em nível de hardware em relação aos demais usuários.
• Sem acesso por padrão. Um Bot pode usar apenas as contas e os plugins aos quais o usuário ou a equipe lhe conceder acesso.
• Etapas de aprovação humana. Ações sensíveis exigem aprovação do usuário, avaliada por um modelo de revisão independente chamado Auto-review.
• Controle administrativo. Admins da equipe podem definir Regras da equipe, delegação a Cloud Agent, compartilhamento de templates e o limite de execução local. Network Controls, Team Setup, Team Secrets, Allow Local Egress, Action Recording, Forçar Auto-review, regras de Auto-review e a opção de ativação para toda a organização são somente para Enterprise.

As partes se encaixam da seguinte forma:

1. Máquina local. Chat, revisão e aprovações acontecem no dispositivo do membro. O trabalho é executado no computador hospedado. A execução local opcional exige, por padrão, aprovação para cada comando e pode ser desativada.
2. Ambiente. Uma microVM Firecracker persistente por usuário. Todos os Bots executados por esse usuário compartilham esse computador. Admins gerenciam o Grok Bot na página do Grok Bot no dashboard do Cherri Code. Regras da equipe, delegação a Cloud Agent, compartilhamento público de templates e execução no computador local está disponível para admins da equipe. Somente para Enterprise nessa página: a opção de ativação para toda a organização, Network Controls, Team Setup, Team Secrets, Allow Local Egress, Action Recording, Forçar Auto-review, regras de Auto-review e o gerenciamento de computadores para admins da organização. Os membros nunca veem essa página.
3. O Bot. Uso de shell, navegador e computador dentro do computador hospedado. Um Bot não tem acesso por padrão e atua apenas com contas nas quais o membro o autenticou. Ele transfere ao membro as etapas de login, autenticação de dois fatores e pagamento.
4. Plugins. A política de Cherri Code MCP (Model Context Protocol) da sua equipe é aplicada integralmente, permitindo ou bloqueando cada conector. Os tokens OAuth permanecem no backend de conectores do Cherri Code, e os Bots invocam ferramentas sem recebê-los.
5. Cloud Agents. O Grok Bot pode delegar tarefas de programação a computadores separados sob os controles existentes do Cloud Agent. Admins podem desativar a criação de Cloud Agent.
6. Modelos e dados. O Cherri Code gerencia a seleção de modelos. Com o Privacy Mode ativado, os dados do cliente não são usados para treinamento; o Cherri Code aplica isso em seus servidores e, quando a configuração não pode ser verificada, o sistema assume, por padrão, que os dados não serão usados para treinamento.

Como os usuários são isolados

Cada usuário recebe um computador dedicado, com separação em nível de hardware, e não pode acessar o computador de outro usuário. Cada computador é uma microVM Firecracker com seu próprio kernel, memória e dispositivos virtuais.

Para cada usuário, o limite é diferente: todos os seus Bots compartilham um computador, e os Bots isolam personalidades e espaços de trabalho, não recursos computacionais. Considere que um login ou arquivo no computador está disponível para todos os Bots executados por esse usuário, desconecte o navegador das contas de que um Bot não precisa mais e remova arquivos temporários confidenciais quando o trabalho for concluído. Quando uma carga de trabalho precisar de seu próprio computador e conjunto de credenciais, atribua a ela seu próprio usuário do Cherri Code.

Controles de administração

A maioria das configurações do Grok Bot fica na página do Grok Bot no dashboard do Cherri Code, visível apenas para admins. Algumas ficam nas Configurações da equipe, no seu Teams Marketplace ou no seu provedor de identidade. Vários controles estão disponíveis apenas no plano Enterprise; os demais estão disponíveis em Teams e Enterprise. Equipes Enterprise também podem ampliar vários desses controles para um cohort na aba Grok Bot de um grupo; veja Configurações do grupo.

Acesso e identidade

Quem pode usar o Grok Bot e como os membros são provisionados.

Ativar o Grok Bot

O switch de ativação para toda a organização na página do Grok Bot, com Gerenciar acesso de grupos ao lado. Ao ativá-la, abre-se um modal de configuração que aborda o Privacy Mode, os preços e a disponibilidade de modelos. Ao desativá-la, todos os membros são bloqueados, sem que seus computadores sejam excluídos. Veja Ativando o Grok Bot para sua equipe.

Disponível no plano Enterprise.

SCIM

Provisionamento e desprovisionamento SCIM 2.0 pelo seu provedor de identidade. Os membros fazem login no Grok Bot com a conta Cherri Code, então a configuração de SCIM e SSO que você já tem continua valendo. Para as etapas no Okta e no Entra ID, incluindo atribuição de app e regras de login para o navegador do computador, consulte Configurar identidade e acesso.

Disponível no plano Enterprise.

Recursos do agente

O que os Bots podem fazer em nome dos membros. Cada controle se aplica aos Bots de todos os membros.

Cloud Agents

Permite ou bloqueia que os Bots deleguem tarefas de programação aos Cloud Agents do Cherri Code. A chave fica na página do Grok Bot, vale para toda a equipe e está ativada por padrão. O trabalho delegado é executado em computadores separados, sujeito aos controles de Cloud Agent que você já tem. Desative quando sua equipe não precisar de delegação.

Compartilhamento público de templates

Controla se os membros podem publicar templates do Bot fora da sua equipe. Quando desativado, o compartilhamento fica restrito à equipe, e o Cherri Code aplica a política em seus servidores, inclusive para templates que já estão públicos. Equipes Enterprise começam com o compartilhamento público desativado; as demais equipes já começam com ele permitido. Para saber o que um template compartilhado contém, veja Compartilhar um Bot.

Política de conectores

O Grok Bot herda a política de conectores do Cherri Code da sua equipe. Não há uma lista de conectores separada para o Grok Bot, e os conectores aparecem como plugins no app. Defina quais servidores os membros podem usar a partir do seu Team Marketplace, na página Plugins & MCPs do dashboard, e não na página do Grok Bot. A lista de permissão de MCP é somente para Enterprise; consulte MCP server trust management. Qualquer conector permitido fica disponível para todos os Bots que um membro executa, e um bloqueado aparece como Desativado pelo administrador da equipe. Não é possível enviar conectores aos membros, seja de forma obrigatória ou ativada por padrão.

Execução no computador local

Limita o que os Bots podem fazer na máquina do próprio membro por meio do app de desktop: abrir arquivos e executar tarefas. Escolha Sempre permitir, Perguntar sempre ou Nunca permitir na página do Grok Bot. Sempre permitir, o valor padrão, deixa a decisão a cargo de cada membro, cuja configuração individual, por padrão, pede confirmação antes de cada tarefa. Perguntar sempre exige aprovação em toda tarefa local, e Nunca permitir desativa a execução local para toda a equipe. A configuração individual do membro continua valendo quando for mais restritiva que a da equipe. Escolha Nunca permitir, a menos que os Bots tenham um motivo específico para trabalhar nas máquinas dos membros. Veja execução local.

Allow Local Egress

Permite que os membros roteiem o tráfego web do Grok Bot pelo próprio computador. Quando desativado, a opção fica indisponível no Grok Bot. O botão vem ativado por padrão. Ao desativá-lo, as rotas ativas são encerradas em até cinco minutos. Ao reativá-lo, a escolha anterior de cada membro é restaurada. Veja Rotear o tráfego pelo seu desktop.

Disponível no plano Enterprise.

Regras e aprovações

As orientações que os Bots seguem e a camada de revisão que bloqueia ações.

Regras da equipe

Regras que os Bots de todos os membros seguem. Adicione-as na página do Grok Bot e defina o escopo de cada regra para Cherri Code, Grok Bot ou ambos. As regras aplicadas ao Grok Bot são sempre obrigatórias, ou seja, os membros não podem desativá-las. Mantenha-as curtas e em pequeno número, como "nunca mover dados da empresa para contas pessoais". As regras orientam um Bot; para o comportamento de aprovação, use as regras de Auto-review. Para orientações que valem apenas para um grupo, adicione Group Rules em Configurações do grupo.

Forçar Auto-review

Impede que os membros desativem o Auto-review. A chave fica na página do Grok Bot e vem desativada por padrão. Quando está ativada, os Bots sempre verificam ações arriscadas antes de executá-las e pedem aprovação quando necessário. Ative-a antes de depender das regras de Auto-review da equipe. Um grupo pode remover o bloqueio para seus próprios membros com Don't enforce for this group; veja Configurações de grupo.

Disponível no plano Enterprise.

Regras de Auto-review

Regras "Ask first" e "Allow automatically" válidas para toda a equipe, aplicadas aos Bots de cada membro além das regras individuais. Adicione-as em "Configure Rules" na página do Grok Bot; as alterações são salvas automaticamente. Os membros veem as regras da equipe em "Settings" > "General" > "Auto-review", mas não podem editá-las nem excluí-las, e "Ask first" prevalece em caso de conflito entre regras. Desativar a imposição faz com que as regras da equipe deixem de ser aplicadas. Veja aprovações e Auto-review.

Disponível no Enterprise plan.

Computadores e rede

Como os computadores da equipe são configurados, o que eles podem acessar e como recriá-los ou encerrá-los.

Network Controls

Restringe quais destinos os computadores da equipe podem acessar. Escolha um de quatro modos, de permitir tudo até uma lista de permissão da equipe com domínios e faixas de IP. Directory groups podem ter sua própria política, e um bloqueio faz a política da equipe se aplicar a todos. Equipes sem uma política permitem tudo por padrão. Consulte a política de rede para conhecer os modos e como uma nova política chega aos computadores em execução.

Disponível no plano Enterprise.

Team Setup

Manifestos de scripts de instalação que rodam em todo computador da equipe, garantindo que as mesmas ferramentas estejam presentes em todos os ambientes. Não inclua valores de secrets nos script de configuração; quando um script precisar de uma credencial, armazene-a como um Team Secret e leia-a do ambiente. Os membros veem a configuração gerenciada em Team Setup no app, onde podem revisá-la ou reinstalá-la. Para saber como os manifestos são executados e como instalar um client de rede que alcance serviços privados, consulte conectar-se a redes privadas. Para rodar scripts extras apenas nos computadores de um cohort, adicione-os em Configurações do grupo.

Disponível no plano Enterprise.

Team Secrets

Valores compartilhados por toda a equipe que os scripts de configuração do Team Setup leem como variáveis de ambiente, permitindo que um script use uma chave de licença, uma auth key ou um token de serviço sem que o valor apareça no manifesto. Adicione-os em Team Secrets na página do Grok Bot: cada segredo consiste em um nome de variável de ambiente e um valor. O Cherri Code armazena o valor criptografado, e o dashboard nunca mais o exibe depois que você o salva. Admins da equipe, incluindo admins não pagos, podem adicioná-los, substituí-los ou excluí-los.

Como eles chegam ao computador:

• Todo Setup Script e Check Script nos seus manifestos do Team Setup, e nos Setup Scripts de grupo, é executado com os segredos da equipe no ambiente. Referencie um segredo pelo nome, por exemplo "$MY_LICENSE_KEY".
• Os segredos existem apenas no ambiente do processo do script. Quando o script termina, o valor desaparece, a menos que o script o tenha gravado em algum lugar; por isso, não armazene no computador nada que você não queira deixar acessível a todos os Bots executados por esse membro.
• A saída dos scripts é verificada em busca de valores de segredos antes de ser registrada em log, e as correspondências são ocultadas.
• Um computador só recebe segredos quando o Team Setup dele vem de exatamente uma equipe. Um membro cujo computador aplica a configuração de duas ou mais equipes não recebe segredos de nenhuma delas, já que scripts de equipes diferentes compartilham o mesmo usuário do computador.
• As alterações, incluindo valores rotacionados, entram em vigor na próxima vez que os scripts forem executados: quando um computador é iniciado, na atualização periódica ou quando você o recria. Consulte Implantar em computadores existentes.

Limites: até 100 segredos por equipe, até 32 KB por valor e até 96 KB no total. Os nomes devem ser nomes válidos de variáveis de ambiente, e nomes reservados pelo tempo de execução do computador, como PATH, HOME e qualquer um que comece com SAND_ ou LD_, são rejeitados ao salvar. Os Team Secrets são destinados a scripts que você controla. Eles não disponibilizam valores diretamente para os Bots e são separados dos segredos que os membros armazenam em um Bot. Eles não estão disponíveis pela API de administração.

Disponível no plano Enterprise.

Grok Bot Computers

Permite que administradores da organização recriem ou encerrem os computadores de vários membros de uma só vez, com um resultado para cada membro. Permissões de Admin da equipe não bastam, porque um mesmo computador abrange todas as equipes às quais o membro pertence. Recriar leva os membros para a latest image e o Team Setup, mantendo seus Bots, arquivos e logins. Encerrar finaliza o trabalho atual do membro e preserva o disco persistente; na próxima sessão, o membro inicia um computador novo sobre ele. O Terminate Inactive Computers, logo abaixo, faz esse encerramento por você quando um computador fica 30 dias sem uso. Ele vem desativado por padrão. Nenhuma dessas ações remove o acesso: para isso, remova o membro da equipe ou desative o Grok Bot para o grupo dele e revogue as sessões no seu provedor de identidade. Veja Manage Grok Bot computers.

Disponível no plano Enterprise.

Logging e auditoria

O que é registrado e para onde vai.

Action Recording

Registra o que um Bot fez: cada chamada de ferramenta e como ela terminou, a decisão que a permitiu ou recusou (Auto-review, um hook ou o membro), chamadas de ferramenta de conector (MCP), comandos de shell, navegações do navegador, sessões de uso de computador, transferências de arquivos, mensagens enviadas pelo Bot, execuções de rotinas, intervenções de guardrails, skills lidas e trabalho delegado a subagentes ou agentes na nuvem. Os eventos são metadados, sanitizados antes de serem armazenados ou exportados. Os comandos de shell passam por remoção de secrets; as navegações do navegador mantêm cada página como scheme://host/path com o título, mas removem query strings e credenciais; as sessões de uso de computador registram a contagem de ações e de capturas de tela e a duração da sessão, sem as capturas de tela, os cliques ou o texto digitado; todos os outros eventos contêm IDs, resultados e durações, nunca argumentos de ferramentas, caminhos de arquivos ou conteúdo de mensagens. A opção fica na página do Grok Bot e vem desativada por padrão. Os eventos registrados não aparecem na página Audit Log. Para recebê-los no seu próprio collector, configure a Exportação do OpenTelemetry, que entrega cada evento com a tag cursor.surface=grok_bot; a Referência do protocolo de exportação do OpenTelemetry lista todos os eventos e atributos. Os detalhes de retenção estão em logging e auditoria.

Disponível no plano Enterprise.

Logs de auditoria

Eventos de admin, segurança e autenticação, além de eventos do plano de controle do Grok Bot: criação de Bots, mudanças de acesso de membros, manifestos do Team Setup, autenticação de MCP, vínculos de contas do Slack e rotinas. Cada linha indica a aplicação que executou a ação, então você pode filtrar o log pelo Grok Bot. Visualize-os na página Audit Log ou envie-os por streaming para o seu SIEM; consulte logs de auditoria. Para as ações executadas pelos Bots, use o Action Recording.

Disponível no plano Enterprise.

Exportação do OpenTelemetry

Transmite métricas de uso e logs do Cherri Code, incluindo ações registradas do Grok Bot, para um collector executado por você. É o caminho do cliente para eventos de Action Recording. Configure em Configurações da equipe > Exportação do OpenTelemetry. Os requisitos de endpoint e o schema de eventos estão em Exportação do OpenTelemetry.

Disponível no plano Enterprise.

Configurações do grupo

Os controles acima definem a base para toda a equipe. Para ampliar essa base para um grupo específico, abra um grupo que pertence à sua equipe em Members > Groups e use a aba Grok Bot. As configurações de grupo só ampliam: um grupo pode conceder aos seus membros mais do que a equipe permite, nunca menos, e um membro que está em vários grupos recebe o resultado mais permissivo. É a mesma regra do acesso a modelos por equipe e grupo. Um controle de grupo mantido no valor da equipe não muda nada, então restrinja os controles na página do Grok Bot e amplie-os grupo a grupo.

A aba tem quatro seções:

• Recursos do agente. Permita Cloud Agents, aumente o limite de Execução no computador local ou ative Allow Local Egress para os membros do grupo quando a equipe tiver essas opções desativadas ou mais restritas. Para o Auto-review, Don't enforce for this group libera o bloqueio de Forçar Auto-review da equipe, permitindo que os membros do grupo desativem o Auto-review; as regras de Auto-review do grupo se combinam com as regras de Auto-review da equipe, e "Ask first" prevalece quando há conflito.
• Network. A política de rede do próprio grupo, conforme descrito em Network Controls. Uma política de equipe bloqueada se aplica a todos.
• Group Rules. Regras para os Bots do grupo, combinadas com as Regras da equipe. Os membros não podem desativá-las.
• Setup Scripts. Manifestos que rodam nos computadores dos membros do grupo junto com o Team Setup. Eles usam a mesma estrutura, rodam da mesma forma, seguem a mesma regra de não incluir segredos e leem os mesmos Team Secrets que os manifestos da equipe; não existem segredos no nível do grupo. Veja como o Team Setup roda seus scripts.

As configurações de grupo se aplicam aos grupos que pertencem à sua equipe, seja gerenciando a associação manualmente ou sincronizando-a via SCIM. Elas são separadas dos grupos da organização. Para controlar quem pode usar o Grok Bot, use Gerenciar acesso de grupos na página do Grok Bot; veja Ativar o Grok Bot para sua equipe.

Disponível no plano Enterprise.

API de administração

Ative o Grok Bot e gerencie recursos, Forçar Auto-review, acesso de grupos, política de rede, regras da equipe e scripts de configuração pela API de administração. Os Team Secrets só podem ser gerenciados pelo dashboard.

Segurança

O modelo de segurança, a política de rede, as aprovações e o Auto-review, a identidade, o logging, o tratamento de dados e as certificações estão em Segurança do Grok Bot. As dúvidas mais comuns de revisão estão no FAQ de segurança do Grok Bot.

Configuração recomendada

Para implantações sensíveis à segurança, esta é a configuração básica recomendada.

Para administradores:

1. Configure os Network Controls. Somente para Enterprise. Equipes sem uma política têm como padrão permitir tudo. Equipes self-serve não podem definir isso. Consulte Segurança do Grok Bot.
2. Audite a política de conectores no Teams Marketplace antes de habilitar o Grok Bot. Qualquer conector permitido fica disponível para todos os Bots executados por um membro.
3. Ative o Forçar Auto-review antes de depender das regras da equipe. Somente para Enterprise. Os membros podem adicionar regras pessoais mais rígidas por cima, e "Ask first" prevalece quando as regras entram em conflito.
4. Defina Execução no computador local como Nunca permitir, a menos que os Bots precisem agir nas máquinas dos membros. O padrão deixa a escolha para cada membro.
5. Desabilite a criação de Cloud Agents se não precisar de delegação.
6. Mantenha desativado o compartilhamento público de templates a menos que os membros devam publicar templates de Bots fora da equipe.
7. Adicione regras de Auto-review da equipe. Somente para Enterprise. Contemple ações que sempre devem pedir permissão antes ou que podem prosseguir automaticamente. Implantações em produção, e-mails externos, pagamentos e aceitação de termos legais são bons exemplos de "Ask first". Mantenha as regras automáticas restritas.
8. Restrinja o login a dispositivos gerenciados por meio do seu provedor de identidade. O login no Grok Bot usa seu SSO; portanto, uma política de login baseada no dispositivo se aplica a ele. Isso restringe o login, não o computador hospedado em si.

Para membros:

1. Nunca cole credenciais no chat. A solicitação de segredo mascarado é o método compatível.
2. Prefira Permitir uma vez a Sempre permitir para ações que envolvam contas, dinheiro ou recursos compartilhados.
3. Faça login no navegador do Bot em contas adequadas à tarefa e faça logout das contas de que ele não precisa mais. Use contas de serviço com escopo definido quando o sistema de origem oferecer suporte a elas.
4. Comece novas funções com tarefas somente leitura e resultados em rascunho e mantenha o envio, a publicação, as compras, a exclusão e as alterações em produção sujeitos à aprovação.
5. Revise regularmente os plugins instalados e as rotinas ativas e pause uma rotina quando o sistema de origem mudar.

Perguntas frequentes

Perguntas sobre isolamento, saída, aprovações, logging e tratamento de dados estão nas FAQ de segurança do Grok Bot.

Páginas relacionadas

• Implantar o Grok Bot na sua organização
• Segurança do Grok Bot
• FAQ de segurança do Grok Bot
• Configurar identidade e acesso
• Conecte-se a redes privadas
• Configurar proxies com inspeção TLS
• Manage Grok Bot computers
• Trabalhe com o Grok Bot
• API de administração
• Insights de Conversas do Grok Bot
• Planos e faturamento
• Privacidade e governança de dados