Grok Bot-tutorial: een wekelijkse AI-onderzoeksagent bouwen

Wat is Grok Bot?

Grok Bot is de agent-app van SpaceXAI, beschikbaar via Cursor, om benoemde bots te maken die hun rol en gesprek tussen taken behouden. Het is apart van de Grok-chatapp en Grok Build, de code-CLI.

De cyclus van Grok Bot werkt anders dan die van de meeste andere AI-assistenten. Jij geeft een beoogd resultaat, de bot werkt in de apps en op de websites die de taak raakt, en keert terug met óf afgerond werk óf een vraag die jouw oordeel vereist. Voorkeuren en rolcontext blijven tussen gesprekken behouden, al hoort alles wat wekelijks verandert in een bestand dat de Bot leest in plaats van in z’n geheugen.

Voor meer achtergrond raad ik onze Grok Bot-gids aan.

Hoe bots, skills en routines werken in Grok Bot

We hebben vier termen nodig voor deze Grok Bot-tutorial. SpaceXAI’s gids over bots en cloudcomputers en productgidsen definiëren ze als volgt:

• Bot: Een agent met een naam, een taak, een eigen gesprek en opgeslagen context.
• Cloudcomputer: Een persistente machine die door elke Bot op je account gedeeld wordt, met een eigen browser, bestanden en een terminal. Hij blijft draaien nadat we de laptop hebben dichtgeklapt.
• Skill: Een set instructies om een taak uit te voeren, het resultaat te controleren en te weten wanneer er om goedkeuring gevraagd moet worden.
• Routine: Een opdracht die één Bot vertelt wanneer een taak moet draaien, op schema of na een ondersteunde gebeurtenis.

Die volgorde komt uit de officiële gids voor skills en routines, die testen vóór inplannen zet.

Delen Grok Bots één cloudcomputer?

Ja. De Grok Bot-FAQ zegt dat de computer bij je account hoort, niet bij een individuele Bot. Elke Bot kan de browsercookies, opgeslagen logins en bestanden op die computer zien, al krijgt elke Bot een eigen scherm voor z’n browsertaken.

We houden de Scout-workflow eerst op openbare pagina’s. Als we later inloggen bij DataCamp, Notion of een andere dienst, kan elke Bot die sessie gebruiken. Het verwijderen van Scout garandeert niet dat gedeelde bestanden of loginstatus verdwijnen, dus we moeten uitloggen en opruimen wat we niet meer beschikbaar willen hebben voor andere bots.

Eén account, één computer, veel bots. Afbeelding door de auteur.

Een wekelijkse DataCamp Learning Scout bouwen met Grok Bot

De Scout leest een leerprofiel en tijdbudget en geeft dan een kort plan terug. Onze lerende kent Python en basis-LMM-concepten, is nieuw met agentorkestratie en heeft deze week vier uur. Onze AI Agent Fundamentals-track duurt zes uur, dus de hele track past niet.

De limiet van vier uur vormt de grens; het uitvoerformaat geeft aan wanneer het plan klaar is.

Wat moet de Scout-Bot opleveren?

Voor elke resource moet de Scout de volgende details van de cursuspagina teruggeven: 

• Titel en link
• Type (cursus, track, project of tutorial)
• Niveau (basic, intermediate of advanced)
• Duur (als die op de pagina staat)
• Reden voor de keuze
• Plaats in de volgorde

Het moet eindigen met de totale tijd en één weekdoel. Als een pagina geen duur vermeldt, is het antwoord "niet vermeld", geen schatting.

Voor onze lerende zijn drie gecontroleerde resources genoeg. De Scout mag er minder teruggeven als het beschikbare materiaal niet past bij doel, niveau of budget.

Elke reden moet naar deze lerende verwijzen. "Bouwt voort op de concepten uit de Basic-cursus ervoor en sluit aan bij het Python-niveau van de lerende" verklaart de keuze. "Behandelt AI-agents" niet. Ook de volgorde heeft een reden nodig, zoals eerst de basiscursus afronden vóór een project dat dezelfde ideeën veronderstelt.

Waarom zoekfragmenten niet genoeg zijn

Zoekfragmenten kunnen verouderd zijn of het niveau en de duur weglaten. De Scout mag ze gebruiken om kandidaten te vinden, maar moet de DataCamp-pagina lezen vóórdat een resource aan het plan wordt toegevoegd.

We moeten deze regel in de instructies zetten. Een site kan de Bot alsnog blokkeren, een login vereisen of een CAPTCHA tonen. De Bot moet ons dan vragen het over te nemen.

Hoe krijg je toegang tot Grok Bot

Door de samenwerking tussen SpaceXAI en Cursor zijn er twee manieren om Grok Bot te gebruiken

Grok Bot-abonnementen

Grok Bot heeft geen permanent gratis niveau. Cursor biedt momenteel een beperkte proef als gebruikstegoed. Betaalde toegang loopt via een in aanmerking komend Cursor-abonnement of een SuperGrok-abonnement. In beide gevallen log je in met Cursor.

Het officiële Grok Bot-account zegt nu dat alle SuperGrok- en Cursor Pro-abonnees toegang hebben, en dat wekelijkse gebruikslimieten voor alle gebruikers zijn gereset. De helppagina van Cursor weerspiegelde nog niet elk onderdeel van die aankondiging toen we ’m controleerden, dus bevestig de huidige status op de abonnementenpagina of in de app wanneer je dit leest.

Voor accounts die SuperGrok koppelen, beschrijft Cursor Help de koppeling nog steeds als een permanente gebruikstoekenning die het Cursor-abonnement niet wijzigt. Cursor telt agentstappen en tokens, niet berichten, dus check Usage and Billing vóór de onderzoeksrun en de routinetest.

Privacy-instellingen en platformondersteuning

Grok Bot vereist cloudgegevensopslag. Hij start niet als je Cursor-account Legacy Privacy Mode gebruikt. Verander die instelling in het privacypaneel van Cursor.

Grok Bot ondersteunt macOS op Apple silicon of Intel, Windows op x64 of Arm64, en iPhone op iOS 18 of later. Als je Linux, Android of iPad gebruikt, controleer dan de actuele platformlijst wanneer je dit leest, want ondersteuning kan veranderd zijn.

Abonnementen bevatten wekelijks gebruik, maar Cursor publiceert geen één getal dat voor elk plan geldt. Een proef biedt gebruikstegoed voor een periode van 7 dagen, en één grote taak kan dat verbruiken.

Stap 1: Installeer Grok Bot en maak de Bot

We hebben geen API-sleutels, lokale ontwikkelomgeving of DataCamp-login nodig voor het onderzoek zelf. Cursussen starten is apart en kan een account vereisen. Installatie kost slechts een paar stappen, terwijl de Bot-beschrijving meer aandacht vraagt dan de installer.

Installeren en inloggen

Download de desktopapp via de Grok Bot-onboardingpagina en kies de build voor jouw machine. Log in via de browser met je Cursor-account. Als je organisatie single sign-on gebruikt, volg dan het gebruikelijke inlogscherm.

De eerste start eindigt op een scherm "Maak kennis met een toekomstige teamgenoot" terwijl de cloudcomputer opstart. Als het vastloopt, sluit Grok Bot volledig af en open ’m opnieuw vóórdat je iets anders probeert. Blijft het probleem, update dan de desktopapp, sluit volledig af en open opnieuw, open vervolgens Agent Computer en geef het de tijd om klaar te zijn. Gebruik Recover eerst en Reset alleen als laatste redmiddel, want Reset kan werk weggooien dat nog niet gesynchroniseerd is.

Grok Bot-desktopapp na inloggen. Afbeelding door de auteur.

Schrijf een beschrijving die langer meegaat dan deze week

Maak de Bot met New of Cmd/Ctrl+N, kies Create new agent en open Bot actions → Edit Profile. Noem ’m Scout en geef de titel DataCamp Learning Scout.

De beschrijving bevat regels die elke week gelden. Het onderwerp van deze week hoort elders. Voeg regels toe als deze:

• Stel DataCamp-leercontent samen en match die met een opgegeven vaardigheidsniveau en tijdbudget.
• Behandel dit profiel als een vaste context, niet als een taak. Wacht op een apart bericht vóór je onderzoek start.
• Gebruik alleen het onderwerp en tijdbudget uit de huidige taak. Hergebruik geen onderwerp uit een eerder gesprek.
• Open de eigen DataCamp-pagina van elke kandidaat vóór je ’m aanbeveelt.
• Citeer niveau en duur exact zoals op de pagina staat, en schrijf "niet vermeld" als de pagina een waarde weglaat.
• Houd bronlinks intact en verzin nooit cursusdetails.
• Geef de voorkeur aan hands-on materiaal als twee resources hetzelfde concept behandelen.

Bij onze eerste setup zag Scout het profiel als een live taak en startte een ongerelateerd ETL-plan. Ik heb ’m gestopt, een nieuwe Scout gemaakt en de twee wachtrichtlijnen hieronder toegevoegd: 

• Stel een verduidelijkende vraag als het leerdoel onduidelijk is, in plaats van te gokken.
• Maak nooit accounts aan, schrijf niet in en koop niets.

De nieuwe Bot wachtte vervolgens op een aparte taak in plaats van vanuit z’n profiel te beginnen.

Een aparte Scout houdt de wekelijkse routine ook uit een lange, algemene chat, zodat elke run alleen de context draagt die nodig is voor leerplannen.

Het is belangrijk om grenzen in het profiel te zetten zodat ze ook gelden wanneer een routine zonder toezicht draait. Houd de beschrijving ook kort genoeg om te herzien wanneer Scouts taak verandert. Stap 2 behandelt het onderwerp en de tijdslimiet.

Scout-profiel bevat duurzame onderzoeksregels. Video door de auteur.

Als je liever niet met een leeg profiel begint, kun je onze Scout-sjabloon toevoegen met dezelfde startrol en beschrijving. Ik heb het profiel hier handmatig gemaakt, zodat elke regel zichtbaar is voordat Scout z’n eerste taak krijgt. Welke route je ook kiest, beoordeel de beschrijving voordat je doorgaat.

Stap 2: Schrijf de eerste onderzoekstaak van de Bot

We kunnen Scout een taak in gewone taal geven, maar het verzoek heeft nog steeds details nodig. De documentatie stelt voor het resultaat, de bronnen, de grenzen, de output en het punt waar de Bot voor review moet stoppen te benoemen.

Wat hoort in het profiel en in het bericht?

Profiel en bericht beantwoorden verschillende vragen:

• Het profiel zegt hoe de Scout werkt. 
• Het bericht zegt wat hij deze week moet doen. 

Daarna slaat de skill de stappen op, terwijl elke routinerun de laatste input leest.

Het profiel dekt al paginacontroles en bronlinks. Geef in het bericht het niveau van de lerende en de taak van deze week, vraag om een paar resources binnen vier uur, en laat de Bot stoppen voor review.

We stuurden de eerste taak als één bericht en voegden geen beperkingen toe terwijl Scout werkte:

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.

Scout startte de browserzoektocht en gaf een plan terug ter review. In het eerste antwoord stond één verkeerd niveau bij een cursus, wat ik in Stap 4 heb gecorrigeerd.

Maak het wekelijkse bestand van de lerende

Botgeheugen is geen betrouwbare registratie van veranderende details. Maak /workspace/learner-profile.md op de gedeelde computer en gebruik dit als de bron van waarheid voor elke wekelijkse run.

# 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

Werk dit bestand bij wanneer doel, budget of de lijst met afgeronde resources verandert. Scout moet het vóór elk plan lezen en stoppen als het ontbreekt of verouderd is.

Stap 3: Onderzoek reviewen in Grok Bots Agent Computer

Het gesprek toont tools, bestanden, vragen en goedkeuringen. Agent Computer toont klikken, typen, navigatie en status. Het verlaten van een van beide weergaven stopt het werk niet.

Waar je op let in Agent Computer

Controleer dat Scout elke cursuspagina opent in plaats van op een zoekfragment te vertrouwen. Noteer ook één resource die hij afwijst en de reden daarvoor.

Als het vastloopt, controleer dan de eerder genoemde login-, CAPTCHA- en goedkeuringsproblemen. Rond alleen de geblokkeerde stap af voordat je de controle teruggeeft. Plak geen wachtwoorden in de chat; gebruik het beveiligde geheimverzoek.

De computerview laat zien dat een pagina is bezocht, maar bewijst niet dat het eindantwoord klopt. Bewaar het gesprekstranscript, want dat toont welke pagina’s de Bot gebruikte en of hij van koers veranderde.

Deze browser-first aanpak past bij onze DataCamp-workflow omdat de pagina zelf het bewijs is. Voor diensten met een ondersteunde connector gebruik je de connector voor gestructureerde data en open je de browser alleen wanneer de pagina visuele controle vereist.

In onze run opende Agent Computer de canonieke Introduction to AI Agents-pagina. De header toonde Basic en 1 hr 30 min. De duur kwam overeen met Scouts antwoord, maar het niveau niet.

Agent Computer geopend op een DataCamp-pagina. Afbeelding door de auteur.

Stap 4: Verifieer en corrigeer de output van de Bot

Hier doen we rustig aan. We leggen het plan naast de DataCamp-pagina’s voordat we het accepteren.

Controleer links, niveaus, vereisten en tijd

Lees het plan regel voor regel. Een nette layout kan nog steeds een verkeerd niveau, een kapotte link of een onjuiste som verbergen. Controleer het volgende:

• Leiden de links naar echte DataCamp-pagina’s met exact die titels?
• Komt het opgegeven niveau overeen met wat op de pagina staat?
• Voldoet de lerende aan elke vermelde vereiste?
• Komt de rekensom uit op vier uur of minder op basis van de op de pagina’s getoonde duur?
• Is er een echte opbouw, of drie inwisselbare beginnercursussen?
• Is er iets alleen binnengekomen omdat een trefwoord matchte?

We moeten de paginaduren optellen in plaats van de totaalduur in het plan te vertrouwen. Als het resultaat boven 4 uur uitkomt, vragen we Scout om het minst relevante item te verwijderen en opnieuw te rekenen.

Scouts eerste plan bevatte Introduction to AI Agents, Building AI Agents with CrewAI en Building AI Agents with Google ADK. De gedrukte duren kwamen uit op 3 uur en 30 minuten, dus het plan paste binnen het budget en liet 30 minuten over.

Het probleem was het niveau van de eerste cursus. Scout schreef Beginner, terwijl de canonieke pagina Basic toonde. We stuurden één correctie:

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.

Scout opende alle drie de pagina’s opnieuw, wijzigde alleen het eerste niveau en hield het totaal op 3 uur en 30 minuten. De correctie was klein, maar bevestigde dat een geldige link en een plausibel label niet genoeg zijn.

Eerste plan naast het gecorrigeerde plan. Afbeelding door de auteur.

Ga om met ontbrekende duren

We moeten XP, video’s of oefeningen niet naar uren omrekenen. Als duurvelden van elkaar afwijken, behouden we elke gedrukte waarde, noemen we het veld en gebruiken we alleen de hoogste bovengrens voor de budgetcontrole.

Sla terugkerende regels op in het Bot-profiel

Na het corrigeren van ons plan heb ik alleen de regel toegevoegd die elke week moet gelden aan de Bot-beschrijving. Een eenmalig onderwerp of tijdslimiet blijft in ons wekelijkse invoerbestand.

Stap 5: Sla de Bot-workflow op als een skill

Twee best practices voor het opslaan van workflows als skills:

• Sla het proces pas op als de handmatige versie werkt. Anders herhaalt de skill gewoon hetzelfde probleem.
• Houd de skill smal: één bronfamilie, één outputformaat en één goedkeuringsgrens. Als hij moet raden welke systemen te gebruiken of wat terug te geven, kan hij afdwalen en meer gebruik verbruiken.

Wat hoort in de skill

Vraag Scout om een skill op te slaan met de naam Weekly DataCamp Learning Plan. Die moet /workspace/learner-profile.md lezen, elke vereiste checken tegenover de achtergrond en afgeronde resources van de lerende, de paginaduren optellen, de afgesproken velden teruggeven en stoppen vóór elke actie die goedkeuring vereist.

Eenmaal opgeslagen, verwijs je ernaar met / in de composer. Als hij niet verschijnt, zet ’m dan aan via Settings → Plugins → Yours.

Opgeslagen skill met inputs en validatie. Afbeelding door de auteur.

Test de skill op een ander doel

Ik wijzigde het doel van de lerende naar LLM-evaluatie, verlaagde het budget naar 3 uur en riep de opgeslagen skill aan met één kort verzoek: "Bouw het plan van deze week met het huidige leerprofiel."

Scout gebruikte Agent Computer en gaf één cursus terug, LLM Application Evaluation with LangSmith, zonder eerdere aanbevelingen uit het plan over AI-agents mee te nemen. Het sloot ook off-topic pagina’s en tutorials zonder gedrukte duur uit.

De canonieke cursuspagina toonde twee duurformaten: een 2 hr-schatting in de samenvatting en een 1 hr - 3 hr-duurchip. Scout kopieerde de chip maar behandelde de bovengrens als een vaste drie uur totaal. We vroegen om het gebruikte veld te benoemen, beide gedrukte waarden te behouden en alleen de bovengrens te gebruiken voor de budgetcontrole.

Een latere vereistencheck vond een belangrijker probleem: de cursus vereist LLM Application Fundamentals with LangChain, die onze lerende niet had afgerond. De canonieke pagina openen was nodig, maar de skill moest ook de vereisten vergelijken met het leerprofiel vóórdat een cursus werd aanbevolen.

Ik heb de skill bijgewerkt om elke vereiste met het leerprofiel te vergelijken en elk conflicterend duurveld te rapporteren vóórdat resources gekozen worden.

Stap 6: Plan de skill als een wekelijkse Grok Bot-routine

Omdat de cloudcomputer blijft draaien zoals eerder beschreven, kan een routine draaien terwijl de laptop dicht is. We testen ’m voordat we op het maandagrooster vertrouwen.

Een wekelijks schema is hier bewust. Dezelfde research elke paar minuten draaien zou gebruik verbruiken zelfs als de leergegevens en DataCamp-pagina’s niet veranderd zijn.

Stel het schema, de tijdzone en grenzen in

We zetten onze tijdzone onder Settings → General → Agent, en maakten daarna de routine met vijf details: 

• Het schema
• Waar het doel en budget te lezen
• Wat terug te geven
• Wat goedkeuring vereist
• Wat te doen als een bron ontbreekt

Als /workspace/learner-profile.md ontbreekt, of Scout niet verder komt, moet de routine het probleem melden en stoppen in plaats van in een lus te blijven proberen. Hij erft de geblokkeerde acties van Scout, terwijl goedkeuring alleen geldt als we later nog een externe actie toevoegen. Beheer routines via View conversation details → Routines.

Maandagroutine met schema en tijdzone. Afbeelding door de auteur.

Draai ’m nu in plaats van te wachten tot maandag

In plaats van te wachten tot maandag startte ik een testrun met de bijgewerkte skill en hetzelfde LLM-evaluatieprofiel. De routine opende de kandidatenpagina’s, rapporteerde alle duurvelden van LangSmith en markeerde de LangChain-vereiste als niet voldaan.

Als hij niet start, check dan of hij aan staat, controleer vervolgens de details (schema, tijdzone, Bot, bron van de lerende, browsersessie) en tot slot het resterende gebruik. Ontbrekende leergegevens of een verlopen sessie kunnen de run stoppen.

De routine liet LangSmith uit het plan, sloot de andere kandidaten uit omdat ze off-topic waren, onvoldoen aan vereisten hadden, of geen vermelde cursusduur hadden, en gaf Totaal: 0 terug. De week opvullen had de validatieregels gebroken.

De run verscheen in de Run history met een voltooiingsvinkje, en het resultaat bleef in het Scout-gesprek staan. Deze laatste test bevestigde dat het schema, de opgeslagen skill, het duurbeleid en de vereistencheck samenwerkten.

Routinetest voltooit en toont geschiedenis. Video door de auteur.

Tot slot

In deze tutorial bouwden we een DataCamp Learning Scout rond één actuele bron voor de lerende, broncontroles, een herbruikbare skill en een wekelijkse routine. Het profiel bevatte de vaste regels, de skill hield de onderzoeksmethode vast en de routine leverde het maandagrooster.

Zoals je ziet, vraagt de weg naar een geplande wekelijkse run die precies doet wat hij moet doen, om wat trial-and-error. De tests brachten drie issues aan het licht die een gepolijst antwoord kan verbergen: Beginner in plaats van Basic, een duurreeks die als vaste totaalduur werd gezien, en een onvervulde vereiste. De eerste twee zijn gecorrigeerd door de canonieke pagina’s opnieuw te openen. De geüpdatete skill ving de derde, en de uiteindelijke routine gaf geen aanbeveling terug in plaats van de regels te verzwakken.

Vanaf hier kunnen we een voltooiingsgeschiedenis toevoegen om herhaalde aanbevelingen te voorkomen, of een Study Coach-bot maken die de door Scout geselecteerde resources omzet in een studieschema. Als Teach a task in de app verschijnt, kunnen we er ook een browserworkflow mee opnemen en een conceptskill maken.

Grok Bots nieuwe X-koppeling kan de ontdekkingsstap van Scout uitbreiden. Een X-profiel koppelen maakt nu een ontwikkelaarsaccount met inbegrepen credits. Voor een research-only Scout houd je schrijfacties op X geblokkeerd en verifieer je elke kandidaat op z’n DataCamp-pagina vóórdat je ’m aan het plan toevoegt.