Premi P per entrare in modalità presentazione · frecce/spazio per avanzare · Esc per uscire
100%
Lezione 9 · La propria istanza di Geode
Dalla IA generativa alla IA agentica · Lezione 9

Creare la propria
istanza di Geode

Oggi si lavora al computer. Partite da una cartella vuota, fate preparare il progetto all'agente e arrivate a una prima lezione della vostra materia, visibile in anteprima, partendo dalla scheda della lezione scorsa.

DestinatariDocenti di scuola superiore
ServeComputer pronto, assistente, scheda di progetto
DurataUn'ora, pausa compresa
Modulo9 di 10
Corso agenti IA01
Lezione 9 · La propria istanza di Geode
Obiettivi e mappa

Alla fine di quest'oraNon serve conoscere i dettagli tecnici del motore. Serve avere un sito vostro, che funziona, con dentro qualcosa che è vostro.

  1. Avete un'istanza propria e funzionante Una cartella con la vostra copia di Geode, la vostra storia di salvataggi e un sito che si apre in anteprima sul vostro computer.
  2. C'è almeno una lezione della vostra disciplina Nata dalla vostra scheda di progetto e controllata da voi.
8 min

Prima di partire

Il controllo dei programmi, la cartella vuota, il messaggio di avvio

12 min

Come lavora l'agente

Le istruzioni che legge, le fasi dell'avvio, come si passa dalla scheda alla lezione

30 min

Laboratorio

La vostra istanza: avvio, aspetto, prima lezione, salvataggio

10 min

Confronto e chiusura

Le tre piattaforme a confronto, e che cosa resta da fare a casa

Obiettivi e mappa02
Lezione 9 · La propria istanza di Geode
Prima di partire · 3 minuti

Tre controlli, prima di toccare GeodeSe uno fallisce, non si va avanti: meglio sistemarlo ora, con aiuto, che a metà dell'avvio.

Che cosaCome si controllaSe non va
Python 3.12In un terminale nuovo, python --version risponde con un numeroWindows: si apre il Microsoft Store o «Python non è stato trovato». Quasi sempre manca la spunta Add python.exe to PATH: si riapre l'installatore, Modify, poi si chiude e riapre il terminale
Gitgit --version risponde con un numeroChiudere e riaprire l'applicazione da cui si lancia il comando. Sul Mac, la richiesta di installare gli strumenti di Apple alla prima chiamata è normale
L'assistenteAperto, con l'accesso fatto, in una modalità che legge e scrive file sul computerAllegare file a una chat non basta: serve una sessione che lavora su una cartella

Chi resta indietro non resta fermo. Guarda a coppie lo schermo di un vicino e recupera l'installazione a fine ora. Il lavoro di oggi si può rifare a casa.

Prima di partire03
Lezione 9 · La propria istanza di Geode
Prima di partire · 3 minuti

Una copia vostra, non un collegamentoGeode è un progetto pubblico che voi non modificate. Quello che nasce oggi è una copia a sé.

Passo 1

Si scarica il progetto

L'agente porta nella vostra cartella i file di Geode: motore, istruzioni, skill, corsi dimostrativi.

→
Passo 2

Si azzera la storia

La copia riparte da zero, con una storia di salvataggi tutta vostra, firmata a vostro nome.

→
Passo 3

Si tolgono i collegamenti

Niente che permetta di pubblicare per sbaglio nel progetto originale. La pubblicazione, se vorrete, sarà sul vostro account.

Perché una cartella vuota. L'agente prepara il progetto dentro la cartella in cui lavora. Se ci sono già altri file, si ferma e vi aiuta a sceglierne un'altra: è voluto, per non mescolare il lavoro.

Dove metterla. Una cartella nuova e con un nome chiaro, ad esempio i-miei-corsi, in un posto che ritrovate: Documenti va bene.

Prima di partire04
Lezione 9 · La propria istanza di Geode
Prima di partire · 2 minuti

Un solo messaggio per cominciareÈ quello scritto nel README di Geode. Si incolla nella cartella vuota, così com'è.

Il messaggio di avvio
Sono un docente e voglio creare il sito dei miei corsi con Geode. Prepara in questa cartella vuota una copia indipendente del progetto https://github.com/mporfido/geode, con una nuova storia locale e senza collegamenti per pubblicare nel progetto originale. Se la cartella contiene già del lavoro, fermati e aiutami a scegliere una cartella vuota. Leggi README.md, AGENTS.md e CLAUDE.md, poi segui .agents/skills/inizia/SKILL.md. Verifica tu Python, Git e le dipendenze, prepara l'ambiente e avvia l'anteprima. Esegui tu i comandi necessari; guidami con passaggi grafici solo quando serve il mio intervento. Parlami in italiano, senza gergo tecnico.
Che cosa chiede
  • La copia indipendente
  • La lettura delle istruzioni
  • I controlli tecnici, fatti dall'agente
  • Un linguaggio senza gergo

Voi non aprite il terminale. I comandi li esegue l'agente: voi leggete che cosa fa e intervenite quando ve lo chiede.

Il messaggio sta nel README di Geode, sezione «Inizia qui»05
Lezione 9 · La propria istanza di Geode
Dimostrazione · 8 minuti

Che cosa legge l'agente, prima di fare qualcosaSi apre il progetto e si guardano, nell'ordine in cui li legge, i tre file che gli dicono come lavorare.

1README.md La presentazione del progetto e il messaggio di avvio. Scritto per voi, in italiano.
2AGENTS.md Le istruzioni per l'agente: il suo ruolo, quale skill usare quando, il confine da rispettare (il motore non si tocca), come si avvia l'anteprima.
3.agents/skills/inizia/SKILL.md La procedura di avvio, in quattro fasi. È un file di testo, come le skill della lezione 6: si legge, e si potrebbe cambiare.

Da notare: è lo stesso schema dei file-guida della lezione 4. Non c'è codice nascosto: l'agente fa ciò che è scritto in questi file, e voi potete leggerlo.

Si guarda il repository di Geode in locale06
Lezione 9 · La propria istanza di Geode
Le skill incluse

Otto procedure già scritteSi chiamano a parole («voglio pubblicare il sito»). Oggi ne usate quattro, in questo ordine.

SkillA che cosa serveQuando
iniziaPrimo avvio: controlli, dati del sito, veste grafica, anteprimaOggi
nuovo-corsoCrea la cartella di un corso con una prima lezione di provaOggi
bozza-lezioneScrive una lezione da un argomento, una scheda o dai vostri appuntiOggi
salvaUna fotografia del lavoro, in localeOggi
app-interattivaUna simulazione o animazione dentro una lezioneLezione 10
pubblicaMette il sito online su GitHub PagesLezione 10
aggiornaPorta nel vostro sito le novità del motore, senza toccare i corsiPiù avanti
nuovo-componenteAggiunge un nuovo tipo di interazione: tocca il motore, solo su richiesta consapevoleDi solito mai
Le skill incluse07
Lezione 9 · La propria istanza di Geode
L'avvio · la skill inizia

Quattro fasi, e voi intervenite in dueL'ordine è fisso. Le fasi 1 e 4 le fa l'agente da solo; nelle altre due serve una vostra scelta.

Fase 1 · l'agente

L'ambiente

Controlla Python e Git, prepara uno spazio isolato per il progetto, installa quanto serve (qui serve la rete), imposta nome ed email per firmare i salvataggi.

Fase 2 · voi

Il modulo

Un solo messaggio con i dati del sito: nome, materia, destinatari. Rispondete tutto insieme, anche a grandi linee.

Fase 3 · voi

La veste grafica

Guardate un'anteprima comparativa di più temi e scegliete quello che preferite.

Fase 4 · l'agente

Il primo avvio

Compila i corsi, apre il sito nel browser e vi invita a fare il giro del corso di benvenuto.

Se l'agente vi interroga a raffica, con venti domande una dopo l'altra, non sta seguendo la procedura: ditegli di seguire la skill inizia.

L'avvio08
Lezione 9 · La propria istanza di Geode
Fase 2 · Il modulo

Una sola risposta, e un'etichetta che non si cambiaIl modulo è una guida, non un vincolo: si può rispondere anche con un paragrafo libero.

Nome del sito«Le lezioni della prof.ssa Rossi»
SottotitoloFacoltativo: «Matematica per il biennio»
Materia, destinatariServono all'agente per scegliere il tono dei testi
FooterFacoltativo: «© Prof.ssa Maria Rossi»
FormuleLe usate spesso nei corsi? Sì, no, dipende
Da decidere adesso

L'etichetta dei progressi

Dal nome del sito l'agente ricava una sigla breve, per esempio lezioni-rossi. È l'etichetta con cui i browser degli studenti salvano i progressi. Dopo la pubblicazione non si cambia più: chi ha già svolto le lezioni li perderebbe.

Prima di scrivere, l'agente vi fa un riepilogo. Controllatelo: un fraintendimento si corregge in un attimo, dopo si trascina.

Fase 2 · Il modulo09
Lezione 9 · La propria istanza di Geode
Fasi 3 e 4 · Aspetto e primo avvio

Si sceglie guardando, non a paroleL'agente prepara una pagina che mostra lo stesso campione con più temi. Voi indicate quello che vi piace.

Tema

Quaderno

Carta a quadretti, inchiostro blu notte, accento rosso penna, caratteri con carattere.

Tema

Salvia

Carta calda con velature verdi ai margini, accento terracotta, forme morbide.

Tema

Sobrio

Carta piena, colori e tipografia essenziali, nessun motivo di sfondo.

Le proposte possono essere di più. L'agente può aggiungerne una o due su misura della vostra materia e dell'età degli studenti. Il tema scelto diventa quello del sito; la pagina di confronto viene poi cancellata.

Poi il primo avvio. Il sito si apre nel browser, all'indirizzo localhost:5000: è sul vostro computer, non è online. Provate il corso benvenuto: è il giro delle cose che la piattaforma sa fare.

Fasi 3 e 410
Lezione 9 · La propria istanza di Geode
La prima lezione

Dalla scheda alla lezione, con una pausa nel mezzoIl metodo della lezione 8 diventa una conversazione, con due skill e un punto di controllo.

Skill nuovo-corso

Il corso

Una breve intervista: titolo, descrizione, ordine delle lezioni. Nasce la cartella del corso, con una lezione di prova.

Rispondete voi
→
Skill bozza-lezione

La scaletta

Prima di scrivere, l'agente propone i passi: titolo, obiettivo e interazione per ciascuno. È il punto in cui si cambia rotta a poco prezzo.

Decidete voi
→
Skill bozza-lezione

La lezione

Scrive i file, compila il sito, prova la lezione con l'occhio dello studente e vi invita ad aprirla.

Scrive l'agente

Incollate la scheda, tutta. Obiettivo, sequenza, interazione e criterio sono ciò che distingue la vostra lezione da una generica. Se l'agente propone una scaletta che non corrisponde alla scheda, dite quale passo è sbagliato e perché.

La prima lezione11
Lezione 9 · La propria istanza di Geode
Il controllo

L'anteprima si prova, non si guardaAprite la lezione e fate voi lo studente: è il modo più rapido per accorgersi di che cosa non va.

Da provare nel browser
  • Rispondete giusto e sbagliato a ogni domanda: la risposta segnata come giusta lo è?
  • Il passo successivo compare quando deve?
  • Lo slider o l'animazione fanno ciò che la scheda prevedeva?
  • Il testo dice solo cose vere, senza esempi inventati?
  • Il tono va bene per quella classe?
Correggere dialogando
Nel passo 3 la domanda è troppo facile: le due risposte sbagliate si scartano subito. Riscrivile in modo che siano errori tipici di uno studente di terza.

Indicate il passo e il motivo. «Non mi piace» non dice all'agente che cosa cambiare. Se invece è una parola o un numero, si corregge direttamente nel file.

Il controllo12
Lezione 9 · La propria istanza di Geode
Il salvataggio

Una fotografia del lavoro, quando lo decidete voiSi chiede a parole: «salva il lavoro». L'agente non salva mai di sua iniziativa.

1

Guarda che cosa è cambiato

E ve lo riassume in una riga: «Da salvare: la nuova lezione e un ritocco ai colori».

→
2

Scatta la fotografia

Con una frase in italiano che dice che cosa avete fatto, non con una sigla.

→
3

Conferma

«Lavoro salvato». Non va online: resta sul vostro computer.

È la rete di sicurezza della lezione 3. Salvate dopo ogni passo che vi soddisfa, prima di chiedere all'agente un cambiamento grande: se non vi piace, si torna indietro.

Salvare non è pubblicare. Le due cose sono separate: la pubblicazione è la lezione 10, ed è una scelta a parte.

Il salvataggio13
Lezione 9 · La propria istanza di Geode
Laboratorio · 30 minuti · al computer, da soli

La vostra istanza, dalla cartella vuota alla prima lezioneCon la scheda della lezione scorsa. Se vi bloccate, la slide 15 elenca i guai più frequenti.

5 min

Cartella e messaggio. Cartella vuota aperta nell'assistente; incollate il messaggio di avvio. Controllate che l'agente prepari l'ambiente senza errori.

8 min

Modulo e tema. Un solo messaggio con i dati del sito, il riepilogo, la scelta del tema sull'anteprima. Annotate l'etichetta dei progressi.

10 min

La prima lezione. Corso e lezione dalla vostra scheda, con la scaletta da approvare. Aprite l'anteprima.

5 min

Provare e correggere. Fate lo studente. Cambiate almeno una cosa, dialogando o nel file.

2 min

Salvate il lavoro. «Salva il lavoro»; controllate che la frase del salvataggio dica quello che avete fatto.

Nessun dato di studenti, nemmeno negli esempi. Una lezione di tre passi che funziona vale più di una completa che non si apre.

Consegna su Classroom: lezione-09-lab-istanza-geode.md14
Lezione 9 · La propria istanza di Geode
Durante il laboratorio

Cinque guai frequenti, e che cosa fareQuasi sempre basta descrivere il problema all'agente, o incollargli il messaggio di errore.

Che cosa succedeChe cosa significaChe cosa fare
L'agente si ferma: la cartella non è vuotaÈ il controllo previstoCreate una cartella nuova e riaprite l'assistente lì
«Python non è stato trovato»Manca il PATH, o è l'alias del Microsoft StoreRiaprite l'installatore di Python, Modify; riaprite l'assistente
L'installazione dei pacchetti non finisceLa rete non lascia uscire il computer, o è lentaAspettate; poi provate un'altra rete (hotspot del telefono) e ditelo all'agente
L'agente fa molte domande una dopo l'altraNon sta seguendo la skill inizia«Segui la skill inizia: manda un solo modulo»
Il sito non si apre nel browserL'anteprima non è partitaChiedete: «Avvia l'anteprima e dimmi l'indirizzo»
Durante il laboratorio15
Lezione 9 · La propria istanza di Geode
Confronto · le tre piattaforme

Stessa cartella, assistenti diversiLe istruzioni stanno in AGENTS.md e nelle skill, che i tre assistenti sanno leggere. Cambia come si parte.

Che cosa serveUna sessione che lavora su una cartella del vostro computer, non una chat con file allegati.
Claude DesktopCodexAntigravity
Dove si lavoraScheda Code, modalità Local, cartella sceltaProgetto aggiunto nell'app, conversazione localeProgetto aggiunto nell'app, modalità locale
AccountPiano che include Claude Code (Pro o Max)Account ChatGPTAccount Google
Come si parteMessaggio di avvio nella cartella vuotaMessaggio di avvio, poi il prompt di adattamentoMessaggio di avvio, poi il prompt di adattamento
ProvatoÈ il percorso su cui il materiale è stato provatoDa verificare in aulaDa verificare in aula
Piani e requisiti cambiano: controllate sul sito di ciascuno.Il prompt di adattamento è in docs/SETUP.md di Geode
Confronto fra piattaforme16
Lezione 9 · La propria istanza di Geode
Chiusura

Quattro cose da portare a casa

  1. Una cartella vuota e un messaggio bastano per partire. L'agente prepara la copia, la storia e l'ambiente: voi controllate che cosa fa.
  2. L'avvio è una procedura scritta, e si può leggere. AGENTS.md e le skill dicono all'agente che cosa fare e che cosa non toccare.
  3. La scheda è il materiale della lezione. Con la scheda l'agente propone, voi correggete: la lezione la provate da studenti.
  4. Si salva spesso, si pubblica poi. La fotografia del lavoro è un gesto a parte, e non mette niente online.

Prossima lezione: personalizzare e pubblicare. Si prosegue con le vostre lezioni, si passa la checklist di revisione e, se lo vorrete, si mette il sito online su GitHub Pages. Per pubblicare serve un account GitHub: createlo a casa prima di venire. Il sito sarà pubblico.

Chiusura17