Guias práticos do Grok Bot
Respostas rápidas para organizar bots, atualizar o app, corrigir plugins, entrar em apps de trabalho, aprovações, notificações e os problemas que costumam se resolver sem reset. A configuração inicial está em Onboarding.
Como faço para organizar bots por projeto ou empresa?
Use as seções da barra lateral para agrupar bots por projeto, cliente ou empresa sem misturá-los.
No desktop:
- Clique com o botão direito em um bot na barra lateral.
- Escolha Mover para nova seção. Se você já tiver seções, escolha Mover para e selecione uma seção ou escolha Criar seção.
- Para dar à seção o nome do seu projeto ou empresa, clique com o botão direito no nome da seção e escolha Renomear.
- Repita o processo com os outros bots que você quer no mesmo grupo.
No iOS:
- Arraste a linha de um bot na barra lateral.
- Toque em Mover para.
- Escolha Nova Seção e dê a ela o nome do seu projeto ou empresa.
- Repita o processo com os outros bots que você quer no mesmo grupo.
As seções são sincronizadas entre o iOS e o desktop. Excluir uma seção move seus bots para Não atribuídos, sem excluir os bots.
No iOS, as seções exigem o Grok Bot v1.2.0 ou posterior. Atualize pela App Store se a opção Mover para não aparecer.
Como faço para ocultar um Bot da barra lateral?
No desktop, clique com o botão direito no Bot na barra lateral e escolha Hide from sidebar. O Bot permanece ativo e mantém seu histórico. Um Bot oculto não envia notificações.
Para exibi-lo novamente no desktop, abra Hidden Bots, clique com o botão direito no Bot e escolha Show in sidebar. No celular, abra Show Hidden Bots e escolha Unhide.
Se ele não aparecer em nenhuma das duas listas, siga as verificações em Meus chats ou bots parecem ter desaparecido.
Como faço para solucionar problemas de Computador do Grok Bot, rotina, connector e inicialização?
A maioria dos problemas operacionais se resolve com um reinício completo. Antes de qualquer outra coisa, feche o Grok Bot por completo (no Mac, escolha Sair na barra de menus, não apenas feche a janela), abra novamente e tente de novo.
Se isso não resolver, identifique o seu sintoma:
| Sintoma | O que tentar | Se continuar |
|---|---|---|
| O computador mostra Reconnecting, Couldn't Reach Grok Bot's Computer, Backup not ready ou Bot failed to respond | Aguarde e clique em Retry, depois feche o app por completo e abra novamente. Faça o Update se ele for oferecido. Use Recuperar se continuar inacessível ou se a atualização parecer travada. | Veja Computador do Grok Bot. Use Reset só como último recurso, e apenas se puder perder trabalho não sincronizado. |
| Os chats parecem ter desaparecido, ou os bots desapareceram da barra lateral | Feche o app por completo e abra novamente. Verifique em outro dispositivo com a mesma conta. Abra Hidden Bots. | Veja Meus chats ou bots parecem ter desaparecido. Não use Reset para procurá-los. |
| Falta um valor de segredo no Shell, ou os segredos parecem apagados após o Update | Um valor salvo não é exibido novamente. Se o nome ainda aparecer em Secrets, ele continua armazenado. | Veja Armazenar segredos com segurança. |
| Uma rotina não está sendo executada | Confirme que a rotina não está Paused e que When to run mostra o agendamento esperado. Veja Por que minha rotina não foi executada? | Se não estiver pausada, mas não for executada há mais de 24 horas sem nenhum erro exibido, relate um bug com o nome do agente e os detalhes da rotina. |
| Um erro ou travamento durante uma execução | Copie o request ID da mensagem e tente a tarefa novamente. Veja Como faço para copiar um request ID?. | Se o mesmo prompt falhar em uma nova execução, relate um bug e inclua o texto do erro e o request ID. |
| Um plugin não autoriza ou aparece como desconectado | Adicione o plugin novamente e conclua o login do provider no seu navegador. Se aparecer Waiting for authorization, use Reopen. Veja Como faço para reconectar um plugin? | Se a reautorização for concluída mas o plugin continuar desconectado, entre em contato com o suporte com o nome do plugin e o email da sua conta. |
| O app travou na inicialização | Feche por completo e abra novamente. No Mac, use Sair na barra de menus. | Se travar em todas as inicializações, entre em contato com o suporte informando sua plataforma e a versão do Grok Bot. |
Ao entrar em contato com o suporte ou relatar um bug, inclua o email da sua Cherri Code account, sua plataforma e versão do Grok Bot, o nome do agente, o texto exato do erro ou uma captura de tela, e os passos que você já tentou. Copie a versão em About.
Como faço para copiar um request ID?
Clique com o botão direito na mensagem e escolha Copy request ID. Você também pode passar o cursor sobre a mensagem, abrir More message actions e escolher Copy request ID.
Cole o ID completo no relato. Se Copy request ID não aparecer no menu, é porque essa mensagem não tem um ID para copiar. Nesse caso, inclua o texto do erro e uma captura de tela.
Como faço para descobrir minha versão do Grok Bot?
Abra o menu da conta e escolha About. A caixa de diálogo mostra a Version, e Copy version info copia a versão, o canal de release e o sistema operacional. É essa a versão que você deve enviar junto com uma solicitação de suporte.
Como faço para atualizar o Grok Bot?
O app para desktop verifica atualizações automaticamente. Quando houver uma atualização pronta, o menu da conta mostrará New update available. Escolha Install e depois Restart to update. Seus Bots continuam trabalhando na nuvem enquanto o app reinicia.
Para verificar manualmente, abra Settings, vá para Updates e escolha Check for Updates. Se houver uma atualização pronta, escolha Restart to Update. A opção Automatic Updates instala as atualizações enquanto você está ausente.
No celular, as atualizações vêm da App Store ou do Google Play. As alterações do produto estão listadas no changelog.
Por que o Grok Bot diz Update required?
O Grok Bot exige uma atualização quando sua versão tem mais de 14 dias e já existe uma versão mais recente disponível. O app mostra Update required e informa que sua versão não é mais compatível.
- Escolha Update.
- Quando o download terminar, escolha Restart to update.
- Se a atualização falhar, escolha Try again. Você também pode escolher Download the latest version e instalá-la manualmente.
No Linux, a tela pode mostrar um comando para executar em vez disso. Escolha Copy command, execute-o em um terminal e depois reinicie o Grok Bot. O comando depende de como você instalou o Grok Bot:
- Debian ou Ubuntu:
sudo apt update && sudo apt install --only-upgrade grok-bot - Fedora ou outros sistemas RPM:
sudo dnf upgrade --refresh grok-bot
Se a tela pedir para baixar e instalar o pacote mais recente, faça isso e depois reinicie o Grok Bot.
No celular, a tela Update required tem um botão Update Grok Bot que abre a App Store ou o Google Play.
O Grok Bot fechou para atualizar, mas continua na versão antiga. O que fazer?
- Verifique a versão. Abra o menu da conta e escolha About.
- Saia completamente do Grok Bot e abra-o novamente. No Mac, escolha Sair na barra de menus em vez de apenas fechar a janela.
- Abra Settings, vá para Updates e escolha Check for Updates. Em seguida, escolha Restart to Update.
- Se a versão ainda não tiver mudado, baixe a versão mais recente em cursor.com/dashboard/bot e instale-a por cima do app atual. Seus Bots e chats ficam vinculados à sua conta, então continuarão disponíveis depois da reinstalação.
- No Linux, execute o comando de atualização do seu sistema. Veja Por que o Grok Bot exibe Update required?
Se a versão antiga continuar voltando, entre em contato com o suporte informando a versão exibida em About e a sua plataforma.
Como faço para alterar o idioma do app?
No desktop, abra Settings, vá para General e escolha um idioma em Language, na seção Appearance. A opção Follow System usa o idioma do seu computador. O Desktop está disponível em 31 idiomas: inglês, africâner, árabe, bengali, chinês (simplificado), chinês (tradicional), tcheco, dinamarquês, holandês, finlandês, francês, alemão, grego, hebraico, hindi, húngaro, indonésio, italiano, japonês, coreano, norueguês bokmål, polonês, português, russo, espanhol, sueco, tailandês, turco, ucraniano, urdu e vietnamita.
No celular, abra Settings e escolha Language. A opção System usa o idioma do seu celular. O app para celular está disponível em inglês, chinês (simplificado), chinês (tradicional), francês, alemão, hindi, japonês, coreano, polonês, português e espanhol.
O idioma escolhido altera os menus e as mensagens do app. Novos Bots escrevem para você nesse idioma, a menos que você escreva para eles em outro. O chat por voz tem sua própria configuração de Language. Confira Chat por voz com um Bot.
Como faço para reconectar um plugin?
Identifique o seu caso:
O cartão de conexão nunca aparece. Um Bot só mostra um cartão de conexão quando um plugin precisa que você faça login. Não fique esperando por ele. Abra Plugins na barra lateral, abra o plugin e escolha Authorize.
O cartão de conexão não faz nada, ou o login não foi concluído. Se o cartão indicar que está aguardando autorização, escolha Reopen para abrir a página de login novamente. Se indicar que a autorização não foi concluída ou falhou, escolha Retry. Conclua o login no navegador em cerca de 10 minutos ou recomece pelo cartão.
O plugin aparece como Added, mas o Bot diz que ele não está disponível. Added significa que o plugin está instalado, não que você está com a sessão iniciada. Abra Plugins, abra o plugin e verifique o status dele:
- Needs auth ou Disconnected: escolha Authorize e conclua o login.
- Disabled by team admin: peça ao admin da sua equipe do Cherri Code para ativá-lo. Veja Por que um plugin aparece como "Disabled by team admin"?
- Connected: envie uma nova mensagem ao Bot e peça que ele tente usar o plugin novamente.
Se ainda não funcionar, escolha Remove, adicione o plugin novamente e faça login. Se isso não resolver, entre em contato com o suporte informando o nome do plugin e o email da sua conta.
Como faço para adicionar uma segunda conta ao mesmo plugin?
Alguns plugins permitem conectar mais de uma conta, como dois espaços de trabalho do Notion.
- Abra Plugins na barra lateral e abra o plugin.
- Em Accounts, escolha Add Another Account.
- Dê um rótulo à conta, como trabalho ou pessoal.
- Escolha Authorize e faça login na segunda conta.
No celular, escolha Authorize new account.
Informe ao Bot qual conta usar pelo rótulo. Por exemplo: "Use meu Notion do trabalho." Todos os Bots da sua conta do Grok Bot podem usar todas as contas conectadas.
Se Add Another Account não aparecer, esse plugin conecta apenas uma conta por vez. Veja Posso conectar duas contas do Gmail?
Como faço para fazer login em um app de trabalho que usa Okta ou SSO?
Seus Bots trabalham no próprio computador na nuvem, não no seu laptop. Impressão digital, Face ID, Windows Hello e chaves de acesso salvas no seu laptop ou celular não funcionam no computador do Bot. Nele, é você quem faz o login.
- Peça ao Bot para abrir o app de trabalho.
- Quando chegar à página de login, o Bot mostra um cartão Computer marcado como Action needed.
- Escolha Take over. Agora você controla o computador do Bot.
- Faça login com um método permitido pela sua empresa, como senha com código ou aprovação por push no celular.
- Escolha I'm done. O Bot continua a tarefa.
Escolha Skip se não quiser fazer login agora.
No Mac e no Windows, você também pode usar uma chave de segurança física, como uma YubiKey, conectada ao seu computador. Abra Settings, vá para General e, em Security Key, ative Use hardware security keys. O Grok Bot pede sua aprovação a cada uso.
Todos os seus Bots compartilham um único computador. Depois que você faz login, todos os Bots da sua conta podem usar esse login até ele expirar. Não faça login em uma conta no computador do Bot se algum dos seus Bots não puder usá-la.
Por que o Bot está me pedindo para aprovar algo?
Um cartão de aprovação significa que o Bot parou e está aguardando. A ação só é executada depois que você escolher.
O Auto-review verifica uma ação antes de executá-la e pergunta quando precisa de você. O cartão diz Revisar uma ação.
- Permitir uma vez libera a ação apenas desta vez.
- Sempre permitir libera esse tipo de ação nas próximas vezes sem perguntar. Isso adiciona uma regra em Regras de Auto-review.
- Negar interrompe esta ação.
Abra Configurações, depois Bot, e use a chave Auto-review. A descrição ali é O Grok Bot verifica cada ação antes de executá-la e pergunta primeiro quando necessário. Em Regras de Auto-review, escreva uma regra curta por ação. Se duas regras entrarem em conflito, Ask first prevalece. Se a chave disser Exigido pelo seu admin, você não pode desativá-la.
Um cartão de segredo, um login de plugin ou uma página que pede sua senha são prompts diferentes. Use o cartão seguro para segredos. Veja Armazenar segredos com segurança.
Onde aparecem as aprovações pendentes?
- No chat. O cartão de aprovação fica no chat desse Bot.
- Na barra lateral. O Bot indica que precisa de atenção.
- Como notificação. Se a chave Notifications do Bot estiver ativada, você recebe um alerta de que o Bot precisa de você. Os alertas no desktop não aparecem enquanto você estiver usando a janela do Grok Bot. Mesmo assim, eles continuam aparecendo na barra lateral.
No celular, permita as notificações do Grok Bot nas configurações do aparelho para receber alertas nele. Veja Como faço para parar as notificações no celular enquanto trabalho no desktop?
Por que uma aprovação expirou?
Uma aprovação de um chat do qual você participa fica aguardando por você. Já uma aprovação de um trabalho iniciado sem você, como uma rotina, um gatilho ou uma mensagem de outro Bot, expira após cerca de 10 minutos. Nesse caso, o cartão passa a mostrar Expired e a ação não é executada.
Para detectar aprovações a tempo:
- Ative Notifications nos Bots que executam rotinas. A chave fica em Bot settings do Bot no desktop e no perfil dele no celular.
- Escolha Sempre permitir para ações em que você confia, assim o Bot não precisa perguntar da próxima vez. Um cartão expirado pode oferecer a opção Sempre permitir this in the future.
- Depois que uma aprovação expirar, peça ao Bot para tentar a tarefa novamente.
Como faço para desativar as notificações de Bots auxiliares?
Um Bot auxiliar é um Bot criado por um dos seus Bots para ajudar no trabalho dele. Ele aparece na sua barra lateral e envia notificações como qualquer outro Bot.
No desktop, abra o chat do Bot auxiliar, clique no nome dele na parte superior e escolha Bot settings. Desative Notifications. A descrição exibida ali é Get notified when this Bot finishes or needs input.
No celular, abra o chat do Bot auxiliar, toque no nome dele na parte superior e desative Notifications.
Você também pode ocultar o Bot auxiliar. Bots ocultos não enviam notificações. Veja Como faço para ocultar um Bot da barra lateral?
Relacionados
- Onboarding
- Perguntas frequentes sobre o Grok Bot
- Alterar o nome, a foto e a descrição de um Bot
- Chats em grupo e mensagens entre Bots
- Chat por voz com um Bot
- Fazer login no Grok Bot
- Planos e faturamento
- Conectar plugins
- Rotinas
- Armazenar segredos com segurança
- Grok Bot no celular
- Computador do Grok Bot
- Obter ajuda