Tutorial su Grok Bot: creare un agente di ricerca AI settimanale

Che cos’è Grok Bot?

Grok Bot è l’app di agenti di SpaceXAI, disponibile tramite Cursor, per creare Bot con nome che mantengono ruolo e conversazione tra un’attività e l’altra. È separata dall’app di chat Grok e da Grok Build, la CLI per il coding.

Il ciclo di Grok Bot funziona in modo diverso rispetto alla maggior parte degli altri assistenti AI. Tu definisci un risultato, il bot lavora tra le app e i siti web necessari al compito in questione e restituisce o il lavoro finito o una domanda che richiede il tuo giudizio. Mantiene preferenze stabili e contesto di ruolo tra le conversazioni, anche se tutto ciò che cambia di settimana in settimana appartiene a un file letto dal Bot, non alla sua memoria.

Per maggiori informazioni di base, ti consiglio di leggere la nostra guida a Grok Bot.

Come funzionano Bot, skill e routine in Grok Bot

Per questo tutorial su Grok Bot ci servono quattro termini. La guida di SpaceXAI ai Bot e ai computer cloud e le guide prodotto li definiscono così:

• Bot: Un agente con un nome, un lavoro, una propria conversazione e un contesto salvato.
• Computer cloud: Una macchina persistente condivisa da ogni Bot del tuo account, con un proprio browser, file e un terminale. Continua a funzionare anche dopo che chiudiamo il laptop.
• Skill: Un insieme di istruzioni per svolgere un’attività, verificarne il risultato e sapere quando chiedere l’approvazione.
• Routine: Un incarico che dice a un Bot quando eseguire un’attività, a orario programmato o dopo un evento supportato.

Questo ordine segue la guida ufficiale a skill e routine, che mette i test prima della pianificazione.

I Grok Bot condividono un solo computer cloud?

Sì. Le FAQ di Grok Bot indicano che il computer appartiene al tuo account, non a un singolo Bot. Ogni Bot può vedere cookie del browser, accessi salvati e file su quel computer, anche se ogni Bot ottiene uno schermo separato per il proprio compito nel browser.

Terremo inizialmente il workflow di Scout su pagine pubbliche. Se in seguito accediamo a DataCamp, Notion o un altro servizio, ogni Bot può usare quella sessione. Eliminare Scout non garantisce che file condivisi o stato di login vengano rimossi, quindi dobbiamo disconnetterci e ripulire ciò che non vogliamo più rendere disponibile agli altri Bot.

Un account, un computer, molti Bot. Immagine dell’autore.

Creare con Grok Bot uno Scout di apprendimento DataCamp settimanale

Lo Scout legge un profilo del discente e il tempo disponibile, quindi restituisce un piano breve. Il nostro discente conosce Python e i concetti base degli LLM, è nuovo all’orchestrazione di agenti e ha quattro ore questa settimana. Il nostro percorso AI Agent Fundamentals dura sei ore, quindi non ci sta tutto.

Il limite di quattro ore stabilisce una soglia; il formato dell’output indica quando il piano è completo.

Cosa dovrebbe restituire lo Scout Bot?

Per ogni risorsa, lo Scout dovrebbe restituire i seguenti dettagli dalla pagina del corso: 

• Titolo e link
• Tipo (corso, track, progetto o tutorial)
• Livello (base, intermedio o avanzato)
• Durata (se indicata nella pagina)
• Motivo della selezione
• Posizione nella sequenza

Dovrebbe concludere con il tempo totale e un obiettivo settimanale. Se una pagina omette la durata, la risposta è "non indicata", non una stima.

Per il nostro discente, bastano tre risorse verificate. Lo Scout può restituirne di meno se il materiale disponibile non rispetta obiettivo, livello o tempo.

Ogni motivazione dovrebbe riferirsi a questo discente. "Presuppone il livello di Python che il discente ha già e sviluppa i concetti trattati nel corso Base precedente" spiega la scelta. "Copre gli agenti AI" no. Anche l’ordine deve avere una ragione, ad esempio completare il corso base prima di un progetto che dà per scontate le stesse idee.

Perché gli snippet di ricerca non bastano

Gli snippet di ricerca possono essere obsoleti o non riportare livello e durata. Lo Scout può usarli per trovare candidati, ma deve leggere la pagina DataCamp prima di aggiungere una risorsa al piano.

Dobbiamo inserire questa regola nelle istruzioni. Un sito potrebbe comunque bloccare il Bot, richiedere un login o mostrare un CAPTCHA. In tal caso il Bot dovrebbe chiederci di intervenire.

Come accedere a Grok Bot

A causa della collaborazione tra SpaceXAI e Cursor, ci sono due modi diversi per accedere a Grok Bot

Piani di Grok Bot

Grok Bot non ha un livello gratuito permanente. Al momento Cursor offre una prova limitata come credito di utilizzo. L’accesso a pagamento avviene tramite un piano Cursor idoneo o un abbonamento SuperGrok. In entrambi i casi, accedi con Cursor.

L’account ufficiale di Grok Bot ora afferma che tutti gli abbonati SuperGrok e Cursor Pro hanno accesso e che i limiti settimanali di utilizzo sono stati reimpostati per tutti gli utenti. La pagina di assistenza di Cursor non rifletteva ancora ogni parte di quell’annuncio al momento del nostro controllo, quindi verifica lo stato attuale nella pagina dei piani o nell’app quando leggi questo.

Per account che collegano SuperGrok, Cursor Help descrive ancora il collegamento come una concessione di utilizzo permanente che non modifica il piano Cursor. Cursor conteggia step degli agenti e token, non i messaggi, quindi controlla Usage and Billing prima dell’esecuzione della ricerca e del test della Routine.

Impostazioni sulla privacy e piattaforme supportate

Grok Bot richiede l’archiviazione dei dati nel cloud. Non si avvia se il tuo account Cursor usa la Legacy Privacy Mode. Modifica questa impostazione nella dashboard privacy di Cursor.

Grok Bot supporta macOS su Apple silicon o Intel, Windows su x64 o Arm64 e iPhone su iOS 18 o successivo. Se usi Linux, Android o iPad, controlla l’elenco delle piattaforme supportate quando leggi questo perché potrebbe essere cambiato.

Gli abbonamenti includono utilizzo settimanale, ma Cursor non pubblica un numero unico valido per ogni piano. Una prova fornisce credito d’uso per una finestra di 7 giorni, e un singolo compito esteso può esaurirlo.

Passo 1: Installa Grok Bot e crea il Bot

Non servono chiavi API, un ambiente di sviluppo locale o un accesso a DataCamp per la ricerca in sé. Iniziare i corsi è un’altra cosa e può richiedere un account. L’installazione richiede solo pochi passaggi, mentre la descrizione del Bot merita più attenzione dell’installer.

Installa e accedi

Scarica l’app desktop dalla pagina di onboarding di Grok Bot, poi seleziona la build per la tua macchina. Accedi tramite browser con il tuo account Cursor. Se la tua organizzazione usa il single sign-on, segui la solita schermata di login.

Il primo avvio si ferma su una schermata "Meet a future teammate" mentre il computer cloud si avvia. Se si blocca, chiudi completamente Grok Bot e riaprilo prima di provare altro. Se il problema persiste, aggiorna l’app desktop, chiudi e riapri completamente, poi riapri Agent Computer e dagli il tempo di terminare. Usa Recover e Reset solo come ultima risorsa, perché Reset può eliminare lavoro non ancora sincronizzato.

App desktop Grok Bot dopo l’accesso. Immagine dell’autore.

Scrivi una descrizione che valga oltre questa settimana

Crea il Bot con New o Cmd/Ctrl+N, scegli Create new agent, poi apri Bot actions → Edit Profile. Chiamalo Scout e assegnagli il titolo DataCamp Learning Scout.

La descrizione contiene regole valide ogni settimana. L’argomento di questa settimana va altrove. Aggiungi regole come queste:

• Seleziona contenuti DataCamp per l’apprendimento e abbinali a un livello di abilità e a un budget di tempo dichiarati.
• Tratta questo profilo come contesto permanente, non come un compito. Attendi un messaggio separato prima di iniziare la ricerca.
• Usa solo l’argomento e il budget di tempo del compito attuale. Non riutilizzare un argomento da una conversazione precedente.
• Apri la pagina DataCamp di ogni candidato prima di consigliarlo.
• Riporta livello e durata esattamente come stampati nella pagina e scrivi "non indicata" quando la pagina omette un valore.
• Conserva intatti i link alle fonti e non inventare mai dettagli dei corsi.
• Preferisci materiale pratico quando due risorse coprono lo stesso concetto.

Al primo tentativo di configurazione, Scout ha trattato il profilo come un compito attivo e ha iniziato un piano ETL non correlato. L’ho fermato, ho creato un nuovo Scout e ho aggiunto le due regole di attesa qui sotto: 

• Fai una domanda di chiarimento quando l’obiettivo di apprendimento è ambiguo, invece di indovinare.
• Non creare mai account, non iscriverti e non acquistare nulla.

Il nuovo Bot ha poi atteso un compito separato invece di iniziare a lavorare dal suo profilo.

Uno Scout dedicato tiene anche la routine settimanale fuori da una chat generale lunga, quindi ogni esecuzione porta solo il contesto necessario per i piani di apprendimento.

È importante inserire limiti nel profilo così che si applichino anche quando una routine gira senza supervisione. Inoltre, mantieni il profilo abbastanza breve da poterlo rivedere quando il lavoro di Scout cambia. Il Passo 2 gestisce l’argomento e il limite di tempo.

Il profilo di Scout contiene regole di ricerca stabili. Video dell’autore.

Se preferisci non partire da un profilo vuoto, puoi aggiungere il nostro template di Scout con lo stesso ruolo iniziale e la stessa descrizione. Qui ho creato manualmente il profilo, così ogni regola è visibile prima che Scout riceva il suo primo compito. Qualunque strada tu scelga, rivedi la descrizione prima di continuare.

Passo 2: Scrivi il primo compito di ricerca del Bot

Possiamo assegnare a Scout un compito in linguaggio naturale, ma la richiesta ha comunque bisogno di dettagli. La documentazione suggerisce di nominare il risultato, le fonti, i limiti, l’output e il punto in cui il Bot deve fermarsi per la revisione.

Cosa va nel profilo e cosa nel messaggio?

Profilo e messaggio rispondono a domande diverse:

• Il profilo dice come lavora lo Scout. 
• Il messaggio dice cosa deve fare questa settimana. 

Dopo di che, la skill conserva i passaggi, mentre ogni routine legge gli input più recenti.

Il profilo già copre i controlli delle pagine e i link alle fonti. Nel messaggio, fornisci il livello del discente e il compito di questa settimana, chiedi poche risorse entro quattro ore e ferma il Bot per la revisione.

Abbiamo inviato il primo compito come un unico messaggio e non abbiamo aggiunto vincoli mentre Scout lavorava:

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 ha avviato la ricerca nel browser e ha restituito un piano da rivedere. La prima risposta riportava il livello sbagliato per un corso, che ho corretto nel Passo 4.

Crea il file settimanale del discente

La memoria del Bot non è un registro affidabile dei dettagli che cambiano. Crea /workspace/learner-profile.md sul computer condiviso e usalo come fonte di verità per ogni esecuzione settimanale.

# 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

Aggiorna questo file quando cambiano obiettivo, budget o elenco dei completati. Scout dovrebbe leggerlo prima di ogni piano e fermarsi se manca o non è aggiornato.

Passo 3: Rivedi la ricerca nell’Agent Computer di Grok Bot

La conversazione mostra strumenti, file, domande e approvazioni. Agent Computer mostra clic, digitazione, navigazione e stato. Passare a un’altra vista non interrompe il lavoro.

Cosa osservare in Agent Computer

Controlla che lo Scout apra ogni pagina del corso invece di affidarsi a uno snippet di ricerca. Annota anche una risorsa che rifiuta e il motivo del rifiuto.

Se si blocca, verifica i problemi di login, CAPTCHA e approvazione menzionati in precedenza. Completa solo il passaggio bloccato prima di restituire il controllo. Non incollare password nella chat; usa la richiesta sicura per i segreti.

La vista del computer mostra che una pagina è stata visitata, ma non prova che la risposta finale sia corretta. Conserva il transcript della conversazione perché mostra quali pagine il Bot ha usato e se ha cambiato rotta.

Questo approccio browser-first si adatta al nostro workflow su DataCamp perché la pagina stessa è la prova. Per i servizi con connettore supportato, usa il connettore per dati strutturati e apri il browser solo quando la pagina richiede un controllo visivo.

Nella nostra esecuzione, Agent Computer ha aperto la pagina canonica di Introduction to AI Agents. L’intestazione mostrava Basic e 1 hr 30 min. La durata coincideva con la risposta di Scout, ma il livello no.

Agent Computer aperto su una pagina DataCamp. Immagine dell’autore.

Passo 4: Verifica e correggi l’output del Bot

Qui rallentiamo. Mettiamo il piano accanto alle pagine DataCamp prima di accettarlo.

Controlla link, livelli, prerequisiti e tempo

Leggi il piano riga per riga. Un layout pulito può comunque nascondere un livello errato, un link rotto o un totale sbagliato. Verifica quanto segue:

• I link puntano a vere pagine DataCamp con quei titoli esatti?
• Il livello dichiarato coincide con quanto stampato nella pagina?
• Il discente ha soddisfatto ogni prerequisito elencato?
• L’aritmetica porta a quattro ore o meno usando le durate indicate nelle pagine?
• C’è una progressione reale, o tre corsi per principianti intercambiabili?
• Qualcosa è entrato solo perché corrispondeva una parola chiave?

Dovremmo sommare le durate dalle pagine invece di fidarci del totale nel piano. Se il risultato supera le 4 ore, chiediamo a Scout di rimuovere l’elemento meno rilevante e ricalcolare.

Il primo piano di Scout conteneva Introduction to AI Agents, Building AI Agents with CrewAI e Building AI Agents with Google ADK. Le durate stampate totalizzavano 3 ore e 30 minuti, quindi il piano rientrava nel budget e lasciava 30 minuti liberi.

Il problema era il livello del primo corso. Scout ha scritto Beginner, mentre la pagina canonica riportava Basic. Abbiamo inviato una correzione:

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 ha riaperto tutte e tre le pagine, ha cambiato solo il primo livello e ha mantenuto il totale di 3 ore e 30 minuti. La correzione era piccola, ma ha confermato che un link valido e un’etichetta plausibile non bastano.

Primo piano accanto al piano corretto. Immagine dell’autore.

Gestisci le durate mancanti

Non dovremmo convertire XP, video o esercizi in ore. Se i campi durata non coincidono, conserviamo ogni valore stampato, nominiamo il campo e usiamo solo il limite superiore per il controllo del budget.

Salva nel profilo del Bot le regole ricorrenti

Dopo aver corretto il nostro piano, ho aggiunto alla descrizione del Bot solo la regola che dovrebbe valere ogni settimana. Un argomento una tantum o un limite di tempo resta nel nostro file di input settimanale.

Passo 5: Salva il workflow del Bot come skill

Due buone pratiche per salvare i workflow come skill:

• Non salvare il processo finché la versione manuale non funziona. Altrimenti, la skill ripeterà semplicemente lo stesso problema.
• Tieni la skill ristretta: una famiglia di fonti, un formato di output e un solo perimetro di approvazione. Se deve indovinare quali sistemi usare o cosa restituire, può perdersi e consumare più utilizzo.

Cosa includere nella skill

Chiedi a Scout di salvare una skill chiamata Weekly DataCamp Learning Plan. Dovrebbe leggere /workspace/learner-profile.md, controllare ogni prerequisito rispetto al background e alle risorse completate del discente, sommare le durate delle pagine, restituire i campi concordati e fermarsi prima di qualsiasi azione che richieda approvazione.

Una volta salvata, richiamala con / nel composer. Se non appare, attivala in Settings → Plugins → Yours.

Skill salvata con input e validazione. Immagine dell’autore.

Testa la skill su un obiettivo diverso

Ho cambiato l’obiettivo del discente in valutazione degli LLM, ridotto il budget a 3 ore e richiamato la skill salvata con una singola richiesta breve: "Crea il piano di questa settimana usando il profilo del discente attuale".

Scout ha usato Agent Computer e ha restituito un solo corso, LLM Application Evaluation with LangSmith, senza riportare raccomandazioni dal piano sugli agenti AI. Ha anche escluso pagine fuori tema e tutorial senza durata stampata.

La pagina canonica del corso mostrava due formati di durata: una stima 2 hr nel sommario e un chip di durata 1 hr - 3 hr. Scout ha copiato il chip ma ha trattato il limite superiore come un totale fisso di tre ore. Gli abbiamo chiesto di nominare il campo usato, conservare entrambi i valori stampati e usare il limite superiore solo per il controllo del budget.

Un successivo controllo dei prerequisiti ha trovato un problema più importante: il corso richiede LLM Application Fundamentals with LangChain, che il nostro discente non aveva completato. Aprire la pagina canonica era necessario, ma la skill doveva anche confrontare i prerequisiti con il profilo del discente prima di raccomandare un corso.

Ho aggiornato la skill per confrontare ogni prerequisito con il profilo del discente e per riportare ogni conflitto tra campi durata prima di scegliere le risorse.

Passo 6: Pianifica la skill come routine settimanale di Grok Bot

Poiché il computer cloud continua a funzionare come descritto in precedenza, una routine può essere eseguita mentre il laptop è chiuso. La testiamo prima di affidarci alla pianificazione del lunedì.

Qui la pianificazione settimanale è una scelta consapevole. Eseguire la stessa ricerca ogni pochi minuti consumerebbe utilizzo anche quando i dettagli del discente e le pagine DataCamp non sono cambiate.

Imposta pianificazione, fuso orario e perimetri

Impostiamo il nostro fuso orario in Settings → General → Agent, poi creiamo la Routine con cinque dettagli: 

• La pianificazione
• Dove leggere obiettivo e budget
• Cosa restituire
• Cosa richiede approvazione
• Cosa fare se una fonte manca

Se /workspace/learner-profile.md manca, o Scout non può procedere oltre, la routine dovrebbe segnalare il problema e fermarsi invece di riprovare in un loop. Eredita le azioni bloccate di Scout, mentre l’approvazione si applica solo se in seguito aggiungiamo un’altra azione esterna. Gestisci le Routine da View conversation details → Routines.

Routine del lunedì con pianificazione e fuso orario. Immagine dell’autore.

Eseguila ora invece di aspettare lunedì

Invece di aspettare lunedì, ho avviato un test con la skill aggiornata e lo stesso profilo di valutazione LLM. La Routine ha aperto le pagine candidate, riportato tutti i campi durata di LangSmith e contrassegnato il prerequisito LangChain come non soddisfatto.

Se non parte, verifica se è attiva, poi controlla i dettagli (pianificazione, fuso orario, Bot, fonte del discente, sessione del browser) e infine l’utilizzo rimanente. Dettagli del discente mancanti o una sessione scaduta possono interrompere l’esecuzione.

La routine ha escluso LangSmith dal piano, escluso gli altri candidati perché fuori tema, con prerequisiti non soddisfatti o senza durata del corso indicata, e ha restituito Totale: 0. Riempire la settimana avrebbe infranto le regole di validazione.

L’esecuzione è apparsa nella Run history con un segno di completamento e il risultato è rimasto nella conversazione di Scout. Questo test finale ha confermato che pianificazione, skill salvata, regole sulle durate e controllo dei prerequisiti funzionavano insieme.

Il test della routine si completa e mostra lo storico. Video dell’autore.

Considerazioni finali

In questo tutorial abbiamo costruito uno Scout per l’apprendimento su DataCamp basato su una fonte attuale del discente, controlli della fonte, una skill riutilizzabile e una routine settimanale. Il profilo conteneva le regole permanenti, la skill conservava il metodo di ricerca e la routine forniva la pianificazione del lunedì.

Come vedi, arrivare a un’esecuzione settimanale programmata che faccia esattamente ciò che deve richiede un po’ di tentativi ed errori. I test hanno fatto emergere tre problemi che una risposta rifinita potrebbe nascondere: Beginner invece di Basic, un intervallo di durata trattato come un totale fisso e un prerequisito non soddisfatto. I primi due sono stati corretti riaprendo le pagine canoniche. La skill aggiornata ha intercettato il terzo e la routine finale non ha restituito alcuna raccomandazione invece di indebolire le regole.

Da qui, possiamo aggiungere uno storico dei completamenti per evitare raccomandazioni ripetute o creare un Bot Study Coach che trasformi le risorse selezionate da Scout in un programma di studio. Se in app compare Teach a task, possiamo anche usarlo per registrare un workflow nel browser e creare una bozza di skill.

La nuova connessione con X di Grok Bot potrebbe estendere la fase di scoperta di Scout. Collegare ora un profilo X crea un account sviluppatore con crediti inclusi. Per uno Scout dedicato alla sola ricerca, mantieni bloccate le azioni di scrittura su X e verifica ogni candidato sulla sua pagina DataCamp prima di aggiungerlo al piano.