Premi P per entrare in modalità presentazione · frecce/spazio per avanzare · Esc per uscire
100%
Lezione 8 · Come funziona math-rocks
Dalla IA generativa alla IA agentica · Lezione 8

Come funziona
math-rocks

Una lezione interattiva è un file di testo. Oggi vedete come nasce, che cosa fa il motore e che cosa resta a voi, e come il testo arriva online. Nelle ultime due lezioni costruite e pubblicate la vostra.

DestinatariDocenti di scuola superiore
ServeCarta e penna; il computer solo per guardare
DurataUn'ora, pausa compresa
Modulo8 di 10
Corso agenti IA01
Lezione 8 · Come funziona math-rocks
Obiettivi e mappa

Alla fine di quest'oraNon serve capire come è fatto il motore. Serve sapere che cosa è vostro e che cosa no, e in quali passi un'idea diventa una lezione.

  1. Sapete spiegare la separazione fra contenuto e motore E perché è proprio quella che permette di lavorare con un agente.
  2. Avete una scheda di progetto per una vostra attività interattiva Pronta da dare all'agente nella prossima lezione.
10 min

Vederla

Una lezione vera, dalla parte dello studente e da quella di chi la scrive

12 min

Contenuto e motore

Che cosa è vostro, che cosa no, e gli ingredienti a disposizione

16 min

Dall'idea al sito

Il metodo di lavoro, gli strumenti, la pubblicazione online

22 min

Laboratorio

La scheda di progetto, su carta. Poi che cosa fare a casa

Obiettivi e mappa02
Lezione 8 · Come funziona math-rocks
Dimostrazione · 10 minuti

La stessa lezione, vista da due partiSi apre una lezione di math-rocks nel browser e, accanto, il file di testo da cui nasce.

Dalla parte dello studente

Una pagina che risponde

  • Si risponde a una domanda e il sistema dice se è giusta
  • Uno slider cambia un numero nel testo, dal vivo
  • Il passo successivo compare quando quello corrente è finito
  • I progressi restano nel browser: niente account
Dalla parte di chi scrive

Un file di testo con pochi segni

  • Titoli, paragrafi e formule: il Markdown della lezione 2
  • Un segno speciale per ogni elemento interattivo
  • Tre trattini fra un passo e il successivo
  • Nessuna riga di programma

Da guardare: quando lo studente muove lo slider, che cosa cambia nel file? Niente. Il file dice che cosa mostrare; come lo si fa funzionare lo sa il motore.

Copione della demo lezione-08-demo-math-rocks.md03
Lezione 8 · Come funziona math-rocks
L'idea di fondo

Il motore e le lezioni stanno in posti diversiÈ la scelta di progetto da cui discende tutto il resto: si può cambiare una cosa senza toccare l'altra.

Il motore

Trasforma il testo in pagine che funzionano

Legge le lezioni, disegna le pagine, controlla le risposte, tiene i progressi nel browser dello studente.

parser/ · routes/ · templates/
static/components/ · tests/
Non si tocca. Non sa niente della vostra materia.
+
Il vostro sito

Ciò che insegnate, e come si presenta

Il testo delle lezioni, il nome e la lingua del sito, i colori, le animazioni che disegnate voi.

content/ · site.yaml
static/theme.css · static/sketches/
È tutto vostro. È l'unica parte su cui si lavora.

Come una stampante e i vostri documenti. Voi scrivete, lei impagina. Se cambiate stampante i documenti restano gli stessi, e i documenti non contengono la stampante.

L'idea di fondo04
Lezione 8 · Come funziona math-rocks
Perché conviene

Tre vantaggi pratici, uno in più con un agente

Aggiornamenti

Il motore migliora, le lezioni restano

Si aggiorna il motore e le vostre lezioni non si toccano: sono in un'altra parte del progetto.

Riuso

Lo stesso motore, materie diverse

math-rocks ha lezioni di matematica. Geode è lo stesso tipo di motore, senza lezioni dentro: ci mettete le vostre, di qualsiasi materia.

Controllo

Le lezioni sono testo

Si leggono, si correggono, si confrontano, si salvano. Come i file delle lezioni da 2 a 7.

Con un agente, la separazione diventa una regola di sicurezza. Il file AGENTS.md di Geode dice all'agente che il suo lavoro sta in content/, in site.yaml e nel tema grafico, e che il motore non si modifica. L'agente lavora in uno spazio piccolo, e quello che fa si controlla.

Perché conviene05
Lezione 8 · Come funziona math-rocks
Come sono fatte le lezioni

Un corso è una cartella, una lezione è un fileDentro il file, un passo è il pezzo di testo fra due righe di tre trattini: un'idea alla volta.

content/ · i corsi del vostro sitocontent/ └── frazioni/ ├── metadata.yaml titolo e colore del corso ├── content-1.md lezione 1 └── content-2.md lezione 2

Corso → lezione → passo. Quando lo studente ha completato gli esercizi di un passo, compare il contenuto che ne dipende e si va avanti.

content-1.md · un passo, con uno slider> id: slider > title: Gli slider # Numeri che si muovono Trascina: ${n}{n|5|0,10,1} Il valore scelto è **${n}**. Portalo al massimo e scrivilo qui: [[10]] :::div.reveal Bene! Ora il passo successivo. :::
Come sono fatte le lezioni06
Lezione 8 · Come funziona math-rocks
Gli ingredienti

Sei cose che lo studente può fareSi progetta una lezione scegliendo, per ogni passo, che cosa deve fare lo studente. Il resto è testo.

IngredienteChe cosa fa fare allo studenteUn'idea
DomandeSceglie fra più risposte, completa uno spazio, scrive la rispostaUn test di ingresso su un testo letto
Slider e verificheMuove un valore e guarda che cosa cambia; porta lo slider su un valore«Che cosa succede se raddoppio?»
Contenuto che si rivelaDopo aver provato, legge la spiegazionePrima si tenta, poi si guarda la regola
ClassificareTrascina espressioni nei gruppi giustiFigure retoriche, tipi di fonti, reazioni
Formule e graficiLegge e usa formule, esplora una curvaUna funzione con un parametro mobile
AnimazioniManipola una piccola figura o simulazione scritta ad hocUn fenomeno che si guarda e si ferma
Gli ingredienti07
Lezione 8 · Come funziona math-rocks
Il metodo di lavoro

Dall'idea alla lezione, in tre passiLo stesso schema delle lezioni precedenti: l'agente fa, voi decidete e controllate.

Passo 1

L'idea

Che cosa deve saper fare lo studente, in quali passi, con quale ingrediente per ciascuno. Si scrive su una scheda, prima di aprire l'agente.

Tocca a voi
→
Passo 2

La bozza

L'agente legge le istruzioni del progetto, sceglie i componenti e scrive i file di testo della lezione.

Tocca all'agente
→
Passo 3

Il lavoro sui file

Aprite i file di testo, verificate che cosa dicono, correggete a mano o dialogando con l'agente, guardate l'anteprima.

Tocca a voi

Non è una catena a senso unico. Dall'anteprima si torna al passo 2 («cambia questa domanda, è troppo facile») o si ritocca direttamente il file. Quello che non si salta mai è il passo 1: senza un'idea chiara, l'agente produce una lezione generica.

Il metodo di lavoro08
Lezione 8 · Come funziona math-rocks
Passo 1 · L'idea

Prima l'obiettivo pedagogico, poi la tecnicaLa scheda di progetto ha quattro campi. Se non riuscite a riempirne uno, non è ancora il momento dell'agente.

ObiettivoChe cosa deve saper fare lo studente alla fine, con un verbo osservabile?
SequenzaDa tre a cinque passi, una sola idea per passo.
InterazionePer ogni passo, quale ingrediente, e perché serve proprio quello.
CriterioCome capite, dalle risposte, che ha funzionato?
Un esempio · analisi di un testo

Obiettivo: riconoscere come una scelta di parole cambia il tono di un brano.

Sequenza: 1 si legge il brano · 2 si sceglie fra tre versioni · 3 si spiega la differenza · 4 si legge il commento.

Interazione: scelta multipla · risposta aperta · contenuto che si rivela dopo la risposta.

Criterio: la risposta aperta nomina almeno una parola e il suo effetto.

Passo 1 · L'idea09
Lezione 8 · Come funziona math-rocks
Passo 2 · La bozza

Si dà all'agente la scheda, non l'argomentoCon un argomento («una lezione sul Risorgimento») si ottiene una lezione generica. Con la scheda, l'agente sa che cosa costruire.

Un messaggio di questo tipo, con la vostra scheda incollata
Questa è la mia scheda di progetto: [obiettivo, sequenza, interazioni, criterio]. Crea il corso e la prima lezione seguendo le istruzioni del progetto. Per ogni passo dimmi quale elemento interattivo hai scelto e perché. Se qualcosa non è chiaro, chiedimelo prima di scrivere.
Che cosa fa l'agente
  • Legge AGENTS.md e le procedure di Geode
  • Segue le skill per creare un corso e una bozza di lezione
  • Scrive i file content-N.md in content/
  • Non tocca il motore

Lo ritrovate: è il metodo della lezione 7. Un'idea precisa in ingresso, la richiesta di dichiarare le scelte, la domanda prima di scrivere. Nella lezione 9 lo fate davvero.

Passo 2 · La bozza10
Lezione 8 · Come funziona math-rocks
Passo 3 · Il lavoro sui file

La bozza è un punto di partenza: il file è vostroL'agente scrive bene e in fretta. Che cosa è vero, che cosa è giusto, che cosa è adatto ai vostri studenti lo decidete voi.

content-1.md · una domanda, come l'ha scritta l'agente## Domanda 2 Il campo viene diviso tra 4 eredi: ognuno possiede 1/4 del terreno. È sempre vero? [[*Falso, solo se le 4 parti hanno la stessa area|Vero, sono 4 parti]] L'asterisco segna la risposta giusta. Se è sul posto sbagliato, lo studente impara il contrario.
Da controllare a mano
  • La risposta segnata come giusta lo è davvero?
  • Le risposte sbagliate sono plausibili, non assurde?
  • Il testo dice solo cose vere, senza esempi inventati?
  • La difficoltà e il tono vanno bene per quella classe?

A mano o con l'agente? Una parola, un numero, una risposta: a mano. Una struttura da rifare: all'agente. Poi si guarda l'anteprima.

Passo 3 · Il lavoro sui file11
Lezione 8 · Come funziona math-rocks
Un aiuto per il controllo · la skill valuta-lezione

Una skill che legge la lezione e la valuta con una grigliaÈ un esempio mio, nel repository di math-rocks. Una rubrica con criteri osservabili, come quelle della lezione 7, applicata a un file di testo.

Che cosa guardaCome lo misura
1 · Numero di passiDa 6 a 8 è l'ideale; meno di 4 o più di 8 fa perdere punti
2 · Lunghezza dei passiQuanti passi stanno fra 10 e 45 righe
3 · Un concetto alla voltaQuanti passi ne introducono più di uno, o senza ponte con i precedenti
4 · SuggerimentiCi sono, sono specifici, stanno prima delle risposte difficili
5 · InterattivitàQuanti passi sono solo da leggere; bonus per le animazioni
6 · PrerequisitiNei primi due passi c'è una domanda su ciò che lo studente sa già
Che cosa restituisce
Un punteggio in decimi, una riga per criterio con il motivo, e un suggerimento concreto, riferito al passo, solo dove il punteggio non è pieno.

Misura la forma, non la verità. Conta passi e domande; non sa se la risposta segnata come giusta lo è. Quel controllo resta a voi.

Non ve la do: è tarata sulle mie preferenze. Ne potete fare una simile, con i vostri criteri: lo stesso metodo della lezione 7, si fa fare, si corregge, si distilla.

Un aiuto per il controllo12
Lezione 8 · Come funziona math-rocks
Gli strumenti, in breve

Tre nomi da sapere, e a che cosa servonoNon vanno imparati a fondo: l'agente li usa per voi. Serve capire che cosa stanno facendo.

Python

Fa girare il motore

È il linguaggio in cui è scritto il motore. Si installa una volta; poi l'agente prepara l'ambiente e avvia l'anteprima sul vostro computer.

Git

Le fotografie del lavoro

Sta sul vostro computer. Ogni «salvataggio» è una fotografia a cui si può tornare: è la rete di sicurezza della lezione 3.

GitHub

La copia online

È un sito che ospita il progetto. Serve per pubblicare, e per non perdere il lavoro se il computer si rompe.

Git e GitHub non sono la stessa cosa. Il primo è un programma sul computer, il secondo è un sito. Il primo si può usare senza il secondo.

Vi servono due gesti. «Salva il lavoro» e «metti il sito online». Le skill di Geode, salva e pubblica, fanno il resto, in italiano, senza gergo.

Gli strumenti, in breve13
Lezione 8 · Come funziona math-rocks
La pubblicazione online

Dal file di testo a un indirizzo webUna volta impostato, si pubblica con un gesto. Il lavoro pesante lo fa GitHub, da solo.

1 · Sul computer

La cartella

Le lezioni in content/, scritte e controllate.

→
2 · Git

Si salva

Una fotografia del progetto, con una frase che dice che cosa è cambiato.

→
3 · GitHub

Si invia

La copia del computer viene caricata sul repository online.

→
4 · Automatico

Si costruisce

GitHub trasforma il testo in pagine web. Voi non fate niente.

→
5 · GitHub Pages

Il sito

Un indirizzo pubblico, del tipo utente.github.io/nome.

Aggiornare è lo stesso giro. Si cambia una lezione, si salva, si invia: il sito si ricostruisce da solo.

Il sito è pubblico. Chiunque abbia il link può aprirlo, e GitHub Pages gratuito non ha siti privati. Pubblicare è sempre una scelta, mai un obbligo.

Gli studenti non hanno account. I progressi restano nel loro browser e non arrivano a voi né a nessun altro.

La pubblicazione online14
Lezione 8 · Come funziona math-rocks
Laboratorio · 20 minuti · su carta, da soli

La scheda di progetto di una vostra attivitàUna cosa che spiegate davvero nelle prossime settimane, e che con un'interazione guadagnerebbe qualcosa.

ObiettivoUn verbo osservabile: «distinguere», «calcolare», «confrontare»…
SequenzaDa tre a cinque passi, una sola idea per passo.
InterazioneUn ingrediente per passo, scelto fra i sei visti. Perché quello?
CriterioChe risposta mi dice che ha funzionato?
3 min

Scegliete l'argomento. Una classe e un momento dell'anno precisi.

9 min

Compilate i quattro campi. Se uno resta vuoto, annotate perché.

6 min

Scambiate la scheda con un vicino, che prova a fare lo studente. Dove si blocca?

2 min

Correggete la scheda. Fotografatela: serve nella lezione 9.

Nessun computer. Se vi viene da aprire l'agente, fermatevi: il punto di oggi è l'idea. Nessun dato di studenti, nemmeno nell'esempio.

Consegna su Classroom lezione-08-lab-scheda-progetto.md15
Lezione 8 · Come funziona math-rocks
Prima della prossima lezione

Preparate il computer, a casaDue installazioni, una volta sola, e un controllo. Se non riesce, venite lo stesso: ci si aiuta all'inizio dell'ora.

1 · Python 3.12

Da python.org

Su Windows, nella prima schermata dell'installazione, spuntate Add python.exe to PATH. Sul Mac si usa il pacchetto «universal2».

2 · Git

Dal sito ufficiale

Su Windows, «Git for Windows» con le opzioni proposte. Sul Mac, gli strumenti da riga di comando di Apple.

3 · Il controllo

Due risposte

In un terminale nuovo, python --version e git --version devono rispondere con un numero di versione.

Non serve ancora un account GitHub. Servirà solo nell'ultima lezione, se deciderete di pubblicare.

Servono anche l'agente e la scheda. L'applicazione scelta nella lezione 2 e la scheda di progetto di oggi.

Guida passo passo in consegna: lezione-08-prerequisiti.md16
Lezione 8 · Come funziona math-rocks
Chiusura

Quattro cose da portare a casa

  1. Il motore non si tocca, le lezioni sono vostre. Contenuto e motore stanno in posti diversi: è questo che rende il lavoro sicuro e controllabile.
  2. Una lezione è un file di testo con pochi segni. Si legge, si corregge, si salva. Se sapete usare il Markdown, la sapete già scrivere.
  3. L'idea viene prima della bozza. L'agente scrive; l'obiettivo, la sequenza e il criterio di riuscita sono vostri.
  4. Pubblicare è un gesto, e una scelta. Salvare e inviare; GitHub costruisce e mette online. Il sito è pubblico, quindi si controlla prima.

Prossima lezione: la vostra copia di Geode. Partite da una cartella vuota, fate preparare il progetto all'agente e arrivate a una prima lezione in anteprima, con la scheda di oggi.

Chiusura17