Tutorial do Grok Bot: construindo um agente semanal de pesquisa em IA

O que é o Grok Bot?

Grok Bot é o app de agentes da SpaceXAI, disponível via Cursor, para criar Bots com nome que mantêm seu papel e a conversa entre tarefas. Ele é separado do app de chat Grok e do Grok Build, a CLI de código.

O ciclo do Grok Bot funciona de forma diferente da maioria dos assistentes de IA. Você define um resultado, o bot trabalha entre os apps e sites que a tarefa tocar e devolve o trabalho finalizado ou uma pergunta que exige seu julgamento. Ele mantém preferências estáveis e o contexto do papel entre conversas, mas tudo que muda semanalmente deve ficar em um arquivo lido pelo Bot, não na memória.

Para mais contexto, recomendo ler nosso guia do Grok Bot.

Como Bots, habilidades e rotinas funcionam no Grok Bot

Precisamos de quatro termos para este tutorial do Grok Bot. O guia da SpaceXAI sobre Bots e computadores em nuvem e os materiais do produto os definem assim:

• Bot: um agente com nome, função, conversa própria e contexto salvo.
• Computador em nuvem: uma máquina persistente compartilhada por todos os Bots da sua conta, com navegador, arquivos e terminal próprios. Ele continua ativo mesmo após fecharmos o laptop.
• Habilidade: um conjunto de instruções para executar uma tarefa, checar o resultado e saber quando pedir aprovação.
• Rotina: uma atribuição dizendo quando um Bot deve rodar uma tarefa, por agenda ou após um evento compatível.

Essa ordem segue o guia oficial de habilidades e rotinas, que coloca o teste antes do agendamento.

Os Grok Bots compartilham um único computador em nuvem?

Sim. O FAQ do Grok Bot diz que o computador pertence à sua conta, não a um Bot específico. Todos os Bots conseguem ver cookies do navegador, logins salvos e arquivos nessa máquina, embora cada Bot tenha uma tela separada para sua própria tarefa no navegador.

Vamos manter o fluxo do Scout em páginas públicas primeiro. Se mais tarde fizermos login na DataCamp, Notion ou outro serviço, todo Bot poderá usar essa sessão. Excluir o Scout não garante a remoção de arquivos compartilhados ou do estado de login, então é preciso sair e limpar o que não quisermos deixar disponível a outros Bots.

Uma conta, um computador, vários Bots. Imagem do autor.

Criando um Scout de aprendizagem DataCamp semanal com o Grok Bot

O Scout lê um perfil do aluno e o orçamento de tempo e retorna um plano curto. Nosso aluno conhece Python e conceitos básicos de LLM, é iniciante em orquestração de agentes e tem quatro horas nesta semana. Nossa trilha AI Agent Fundamentals tem seis horas, então a trilha inteira não cabe.

O limite de quatro horas define um corte; o formato de saída indica quando o plano termina.

O que o Bot Scout deve retornar?

Para cada recurso, o Scout deve retornar os seguintes detalhes da página do curso: 

• Título e link
• Tipo (curso, trilha, projeto ou tutorial)
• Nível (básico, intermediário ou avançado)
• Duração (se exibida na página)
• Motivo da seleção
• Posição na sequência

Ele deve encerrar com o tempo total e um objetivo semanal. Se a página não tiver duração, a resposta é "não listado", e não uma estimativa.

Para nosso aluno, três recursos verificados são suficientes. O Scout pode retornar menos se o material disponível não se encaixar no objetivo, nível ou orçamento.

Cada motivo deve se referir a este aluno. "Parte do Python que o aluno já domina e aprofunda os conceitos do curso Básico anterior" justifica a escolha. "Cobre IA agents" não. A ordem também precisa de justificativa, como concluir o curso básico antes de um projeto que parte das mesmas ideias.

Por que trechos de busca não bastam

Trechos de busca podem estar desatualizados ou omitir nível e duração. O Scout pode usá-los para localizar candidatos, mas deve ler a página da DataCamp antes de incluir um recurso no plano.

Precisamos colocar essa regra nas instruções. Ainda assim, um site pode bloquear o Bot, exigir login ou exibir um CAPTCHA. Nesses casos, o Bot deve pedir para você assumir.

Como acessar o Grok Bot

Devido à colaboração entre SpaceXAI e Cursor, há duas formas de acessar o Grok Bot

Planos do Grok Bot

O Grok Bot não tem uma camada gratuita permanente. O Cursor atualmente oferece um teste limitado como crédito de uso. O acesso pago vem por um plano Cursor elegível ou assinatura SuperGrok. Em ambos os casos, faça login pelo Cursor.

A conta oficial do Grok Bot informa que todos os assinantes SuperGrok e Cursor Pro têm acesso, e que os limites semanais de uso foram redefinidos para todos. A página de ajuda do Cursor ainda não refletia todos os pontos desse anúncio quando verificamos, então confirme o status atual na página de planos ou dentro do app quando você estar lendo isto.

Para contas que vinculam o SuperGrok, o Cursor Help ainda descreve o vínculo como uma concessão permanente de uso que não altera o plano Cursor. O Cursor contabiliza etapas do agente e tokens, não mensagens, então verifique Uso e cobrança antes da pesquisa e do teste da Rotina.

Configurações de privacidade e sistemas compatíveis

O Grok Bot exige armazenamento de dados em nuvem. Ele não inicia se sua conta Cursor usa o Legacy Privacy Mode. Mude essa opção no painel de privacidade do Cursor.

O Grok Bot é compatível com macOS em Apple silicon ou Intel, Windows em x64 ou Arm64 e iPhone com iOS 18 ou superior. Se você usa Linux, Android ou iPad, confira a lista atual de plataformas ao ler isto, pois o suporte pode ter mudado.

As assinaturas incluem uso semanal, mas o Cursor não publica um número único que valha para todos os planos. Um teste oferece crédito de uso por 7 dias, e uma tarefa grande pode consumi-lo de uma vez.

Passo 1: instale o Grok Bot e crie o Bot

Não precisamos de chaves de API, ambiente local de código ou login na DataCamp para a pesquisa em si. Começar os cursos é outra etapa e pode exigir conta. A instalação tem poucos passos; já a descrição do Bot merece mais atenção que o instalador.

Instale e faça login

Baixe o app de desktop na página de onboarding do Grok Bot, depois selecione a versão para sua máquina. Faça login pelo navegador com sua conta Cursor. Se sua organização usa single sign-on, siga a tela de login de costume.

O primeiro lançamento para na tela "Conheça um futuro colega" enquanto o computador em nuvem inicia. Se travar, feche totalmente o Grok Bot e reabra antes de tentar outra coisa. Se o problema persistir, atualize o app desktop, feche e reabra, depois reabra o Agent Computer e dê tempo para concluir. Use Recover e Reset só em último caso, pois o Reset pode descartar trabalho não sincronizado.

App desktop do Grok Bot após login. Imagem do autor.

Escreva uma descrição que sobreviva a esta semana

Crie o Bot com New ou Cmd/Ctrl+N, escolha Create new agent e abra Bot actions → Edit Profile. Dê o nome Scout e o título DataCamp Learning Scout.

A descrição guarda regras que valem toda semana. O assunto desta semana vai em outro lugar. Adicione regras como estas:

• Selecionar conteúdos de aprendizagem da DataCamp e alinhá-los ao nível declarado e ao orçamento de tempo.
• Tratar este perfil como contexto permanente, não como tarefa. Aguardar uma mensagem separada antes de iniciar a pesquisa.
• Usar apenas o tema e o orçamento de tempo da tarefa atual. Não reutilizar um tema de conversa anterior.
• Abrir a página da DataCamp de cada candidato antes de recomendá-lo.
• Citar nível e duração exatamente como impressos na página e escrever "não listado" quando a página omitir um valor.
• Manter os links da fonte intactos e nunca inventar detalhes de curso.
• Preferir material prático quando dois recursos cobrirem o mesmo conceito.

Na primeira configuração, o Scout tratou o perfil como tarefa ativa e começou um plano de ETL sem relação. Interrompi, criei um novo Scout e adicionei as duas regras de espera abaixo: 

• Fazer uma pergunta de esclarecimento quando o objetivo de aprendizagem estiver ambíguo, em vez de adivinhar.
• Nunca criar contas, matricular ou comprar nada.

O novo Bot então aguardou uma tarefa separada em vez de começar a trabalhar a partir do perfil.

Um Scout dedicado também mantém a rotina semanal fora de um chat geral longo, então cada execução carrega apenas o contexto necessário para os planos de estudo.

É importante colocar limites no perfil para que também valham quando uma rotina rodar sem nossa supervisão. Além disso, mantenha o perfil curto o suficiente para revisar quando o trabalho do Scout mudar. O passo 2 trata do tema e do limite de tempo.

O perfil do Scout guarda regras duradouras de pesquisa. Vídeo do autor.

Se você preferir não começar de um perfil vazio, pode adicionar nosso template do Scout com o mesmo papel inicial e descrição. Eu criei o perfil manualmente aqui, para que cada regra ficasse visível antes de o Scout receber a primeira tarefa. Qualquer caminho que você use, revise a descrição antes de continuar.

Passo 2: escreva a primeira tarefa de pesquisa do Bot

Podemos dar uma tarefa ao Scout em linguagem natural, mas o pedido ainda precisa de detalhes. A documentação sugere nomear o resultado, fontes, limites, saída e o ponto em que o Bot deve parar para revisão.

O que vai no perfil e na mensagem?

Perfil e mensagem respondem a perguntas diferentes:

• O perfil diz como o Scout trabalha. 
• A mensagem diz o que ele deve fazer nesta semana. 

Depois disso, a habilidade guarda os passos, enquanto cada rotina lê as entradas mais recentes.

O perfil já cobre checagem de páginas e links de origem. Na mensagem, informe o nível do aluno e a tarefa desta semana, peça alguns recursos dentro de quatro horas e mande o Bot parar para revisão.

Enviamos a primeira tarefa em uma única mensagem e não adicionamos restrições enquanto o Scout trabalhava:

Build me a weekly DataCamp learning plan.

The learner is comfortable with Python, understands basic LLM concepts, is new to AI agent orchestration, and has 4 hours available this week. 
They prefer practical, hands-on material over theory.

Search current DataCamp content on AI agents. 
Open each candidate's resource page before you consider it. 
Pick a small number of resources whose page-listed durations total 4 hours or less, and order them from foundations toward practical application.
For each resource, return the title, the content type, the level and duration exactly as printed on the page, the link, one sentence on why it fits this learner, and its position in the order. 
Then give me the total time and one learning objective for the week.

Do not use search snippets as evidence. 
If a page does not list a duration or a level, write "not listed" instead of estimating. 
If the goal is too broad to plan against, ask me before you continue.

Stop after the plan. 
Do not enroll me in anything.

O Scout iniciou a busca no navegador e retornou um plano para revisão. A primeira resposta trouxe o nível errado para um curso, que corrigi no Passo 4.

Crie o arquivo semanal do aluno

A memória do Bot não é um registro confiável para detalhes que mudam. Crie /workspace/learner-profile.md no computador compartilhado e use-o como fonte da verdade para cada execução semanal.

# Learner profile

Current goal: AI agent orchestration
Weekly budget: 4 hours
Background: Comfortable with Python and basic LLM concepts
Preference: Practical, hands-on resources
Completed resources: None

Atualize este arquivo quando o objetivo, o orçamento ou a lista de concluídos mudar. O Scout deve lê-lo antes de cada plano e parar se estiver ausente ou desatualizado.

Passo 3: revise a pesquisa no Agent Computer do Grok Bot

A conversa mostra ferramentas, arquivos, perguntas e aprovações. O Agent Computer mostra cliques, digitação, navegação e status. Sair de qualquer uma das visões não interrompe o trabalho.

O que observar no Agent Computer

Verifique se o Scout abre cada página de curso em vez de depender de um trecho de busca. Note também um recurso que ele rejeitar e o motivo da rejeição.

Se travar, verifique os pontos citados antes: login, CAPTCHA e aprovações. Conclua apenas o passo bloqueado e devolva o controle. Não cole senhas no chat; use a solicitação segura de segredo.

A visão do computador mostra que uma página foi visitada, mas não prova que a resposta final está correta. Guarde a transcrição da conversa, pois ela mostra quais páginas o Bot usou e se mudou de rota.

Essa abordagem com foco no navegador combina com nosso fluxo na DataCamp porque a própria página é a evidência. Para serviços com conector compatível, use o conector para dados estruturados e abra o navegador só quando a página exigir checagem visual.

Na nossa execução, o Agent Computer abriu a página canônica de Introduction to AI Agents. O cabeçalho mostrava Basic e 1 hr 30 min. A duração bateu com a resposta do Scout, mas o nível não.

Agent Computer aberto em uma página da DataCamp. Imagem do autor.

Passo 4: verifique e corrija a saída do Bot

Aqui é hora de desacelerar. Colocamos o plano ao lado das páginas da DataCamp antes de aceitá-lo.

Confira links, níveis, pré-requisitos e tempo

Leia o plano linha a linha. Um layout limpo ainda pode esconder um nível incorreto, um link quebrado ou um total errado. Verifique:

• Os links levam a páginas reais da DataCamp com esses títulos exatos?
• O nível informado bate com o que a página imprime?
• O aluno cumpre todos os pré-requisitos listados?
• A soma cai em quatro horas ou menos usando as durações mostradas nas páginas?
• Há progressão real, ou três cursos de iniciante intercambiáveis?
• Entrou algo só porque bateu uma palavra-chave?

Devemos somar as durações nas páginas em vez de confiar no total do plano. Se passar de 4 horas, pedimos ao Scout para remover o item menos relevante e recalcular.

O primeiro plano do Scout incluiu Introduction to AI Agents, Building AI Agents with CrewAI e Building AI Agents with Google ADK. As durações impressas somaram 3 horas e 30 minutos, então o plano coube no orçamento e deixou 30 minutos livres.

O problema foi o nível do primeiro curso. O Scout escreveu Beginner, enquanto a página canônica imprimia Basic. Enviamos uma única correção:

Please revise the plan using the exact level labels shown on each course page.

The Introduction to AI Agents page lists its level as Basic, not Beginner. Reopen all three pages and verify each title, level, duration, and canonical URL.

Return the same plan with only the verified corrections. Keep the total at or below 4 hours.

O Scout reabriu as três páginas, mudou apenas o primeiro nível e manteve o total de 3 horas e 30 minutos. A correção foi pequena, mas confirmou que um link válido e um rótulo plausível não bastam.

Primeiro plano ao lado do plano corrigido. Imagem do autor.

Trate durações ausentes

Não devemos transformar XP, vídeos ou exercícios em horas. Se os campos de duração divergirem, preservamos cada valor impresso, nomeamos seu campo e usamos apenas o limite superior para a checagem do orçamento.

Salve regras recorrentes no perfil do Bot

Depois de corrigir nosso plano, adicionei ao perfil do Bot apenas a regra que deve valer toda semana. Tema pontual ou limite de tempo ficam no nosso arquivo semanal.

Passo 5: salve o fluxo do Bot como uma habilidade

Duas boas práticas ao salvar fluxos como habilidades:

• Não salve o processo até a versão manual funcionar. Caso contrário, a habilidade só vai repetir o mesmo problema.
• Mantenha a habilidade enxuta: uma família de fontes, um formato de saída e um limite de aprovação. Se ela tiver que adivinhar quais sistemas usar ou o que retornar, pode se perder e consumir mais uso.

O que vai na habilidade

Peça ao Scout para salvar uma habilidade chamada Weekly DataCamp Learning Plan. Ela deve ler /workspace/learner-profile.md, checar cada pré-requisito com o histórico e recursos concluídos do aluno, somar as durações das páginas, retornar os campos combinados e parar antes de qualquer ação que exija aprovação.

Depois de salva, referencie-a com / no compositor. Se não aparecer, ative em Settings → Plugins → Yours.

Habilidade salva com entradas e validação. Imagem do autor.

Teste a habilidade com outro objetivo

Eu mudei o objetivo do aluno para avaliação de LLMs, reduzi o orçamento para 3 horas e invoquei a habilidade salva com um pedido curto: "Build this week's plan using the current learner profile."

O Scout usou o Agent Computer e retornou um curso, LLM Application Evaluation with LangSmith, sem reaproveitar recomendações do plano de IA agents. Ele também excluiu páginas fora do tema e tutoriais sem duração impressa.

A página canônica do curso mostrava dois formatos de duração: uma estimativa de 2 hr no resumo e um chip de 1 hr - 3 hr. O Scout copiou o chip, mas tratou o limite superior como total fixo de três horas. Pedimos para nomear o campo usado, preservar ambos os valores e usar só o limite superior na checagem do orçamento.

Mais tarde, uma checagem de pré-requisitos achou um problema mais importante: o curso exige LLM Application Fundamentals with LangChain, que nosso aluno não havia concluído. Abrir a página canônica era necessário, mas a habilidade também precisava comparar pré-requisitos com o perfil do aluno antes de recomendar um curso.

Atualizei a habilidade para comparar todos os pré-requisitos com o perfil e relatar todo campo de duração conflitante antes de escolher recursos.

Passo 6: agende a habilidade como uma rotina semanal do Grok Bot

Como o computador em nuvem continua rodando, como explicado antes, uma rotina pode executar mesmo com o laptop fechado. Testamos antes de depender da agenda de segunda-feira.

Aqui a agenda semanal é proposital. Rodar a mesma pesquisa a cada poucos minutos consumiria uso mesmo quando os detalhes do aluno e as páginas da DataCamp não mudaram.

Defina agenda, fuso horário e limites

Definimos nosso fuso em Settings → General → Agent e criamos a Rotina com cinco detalhes: 

• A agenda
• Onde ler objetivo e orçamento
• O que retornar
• O que exige aprovação
• O que fazer se uma fonte estiver ausente

Se /workspace/learner-profile.md estiver ausente, ou o Scout não conseguir avançar, a rotina deve relatar o problema e parar em vez de tentar em loop. Ela herda as ações bloqueadas do Scout, enquanto a aprovação só se aplica se depois adicionarmos outra ação externa. Gerencie Rotinas em View conversation details → Routines.

Rotina de segunda-feira com agenda e fuso. Imagem do autor.

Execute agora em vez de esperar a segunda

Em vez de esperar, iniciei uma execução de teste com a habilidade atualizada e o mesmo perfil de avaliação de LLM. A Rotina abriu as páginas candidatas, reportou todos os campos de duração do LangSmith e marcou seu pré-requisito de LangChain como não atendido.

Se não iniciar, verifique se está ligada; depois confira seus detalhes (agenda, fuso, Bot, fonte do aluno, sessão do navegador) e, por fim, o uso restante. Falta de detalhes do aluno ou sessão expirada podem interromper a execução.

A rotina deixou o LangSmith fora do plano, excluiu outros candidatos por estarem fora do tema, terem pré-requisitos não atendidos ou não terem duração listada e retornou Total: 0. Preencher a semana quebraria as regras de validação.

A execução apareceu no Run history com marca de conclusão, e o resultado ficou na conversa do Scout. Esse teste final confirmou que a agenda, a habilidade salva, a política de duração e a checagem de pré-requisitos funcionaram em conjunto.

Teste da rotina concluído e histórico exibido. Vídeo do autor.

Considerações finais

Neste tutorial, construímos um DataCamp Learning Scout com base em uma fonte atual do aluno, checagens na fonte, uma habilidade reutilizável e uma rotina semanal. O perfil guardou as regras permanentes, a habilidade manteve o método de pesquisa e a rotina forneceu a agenda de segunda-feira.

Como dá para ver, chegar a uma execução semanal agendada que faça exatamente o que deve exige um pouco de tentativa e erro. Os testes revelaram três pontos que uma resposta polida poderia esconder: Beginner em vez de Basic, um intervalo de duração tratado como total fixo e um pré-requisito não atendido. Os dois primeiros foram corrigidos reabrindo as páginas canônicas. A habilidade atualizada capturou o terceiro, e a rotina final não retornou recomendação em vez de afrouxar as regras.

Daqui, podemos adicionar um histórico de conclusão para evitar recomendações repetidas ou criar um Bot Study Coach que transforme os recursos do Scout em um cronograma de estudos. Se Teach a task aparecer no app, também dá para gravar um fluxo no navegador e criar um rascunho de habilidade.

A nova conexão com o X do Grok Bot pode ampliar a etapa de descoberta do Scout. Conectar um perfil do X agora cria uma conta de desenvolvedor com créditos incluídos. Para um Scout apenas de pesquisa, mantenha ações de escrita no X bloqueadas e verifique cada candidato na sua página da DataCamp antes de adicioná-lo ao plano.