Premi P per entrare in modalità presentazione · frecce/spazio per avanzare · Esc per uscire
100%
Lezione 10 · Personalizzare e pubblicare
Dalla IA generativa alla IA agentica · Lezione 10

Personalizzare
e pubblicare

Ultima lezione. Si rifinisce il sito, si controlla con una checklist e, solo se lo volete, lo si mette online. Poi si chiude il corso: che cosa portarsi a casa e da dove ripartire.

DestinatariDocenti di scuola superiore
ServeIl sito della lezione 9, aperto nell'assistente
DurataUn'ora, pausa compresa
Modulo10 di 10
Corso agenti IA01
Lezione 10 · Personalizzare e pubblicare
Obiettivi e mappa

Alla fine di quest'oraNessuna prova finale: l'attività è vostra e la giudicate voi. Contano un sito controllato e un progetto che potete riprendere.

  1. Avete rifinito e controllato un'attività della vostra disciplina Con aspetto e testi ritoccati, e passata alla checklist di revisione.
  2. Sapete che cosa significa pubblicare e potete decidere se farlo Chi vuole mette il sito online; chi no resta in locale, e il lavoro non vale meno.
  3. Portate a casa un progetto riutilizzabile Sapete dove sta, come si riprende e da dove si riparte.
8 min

Personalizzare

Che cosa si cambia e come si continua

10 min

Checklist

Cinque controlli prima di mostrare il lavoro

13 min

Pubblicare

Che cosa è pubblico, che cosa serve, il flusso

20 min

Laboratorio

Rifinire, controllare, se volete pubblicare

9 min

Chiusura

Conservare il progetto, ripartire

Obiettivi e mappa02
Lezione 10 · Personalizzare e pubblicare
Personalizzare · 4 minuti

Che cosa è vostro, che cosa non si toccaÈ la divisione della lezione 8: il motore lavora, voi decidete aspetto, testi e contenuti.

Che cosa cambiareDove staCome si chiede
Nome, sottotitolo, footersite.yaml«Cambia il sottotitolo del sito in …»
Colori e caratteristatic/theme.css, o un tema in static/themes/«Rendi i colori più caldi», «prova il tema salvia»
Ordine dei corsicontent/sections.yaml«Metti il corso di algebra prima di quello di geometria»
Testi e interazionile lezioni in content/, in MarkdownDialogando con l'agente, o a mano nel file
Il motoreparser/, routes/, templates/…Non si tocca. Per le novità c'è la skill aggiorna

Una cosa non si cambia più a sito pubblicato: l'etichetta dei progressi (storage_prefix, lezione 9). Chi ha già svolto le lezioni li perderebbe.

Personalizzare03
Lezione 10 · Personalizzare e pubblicare
Continuare il lavoro · 4 minuti

Da una lezione a un corso, con le vostre fontiLe skill di Geode si chiamano a parole. Le tre più utili per proseguire da soli.

Skill bozza-lezione

Nuove lezioni

Si parte da una scheda di progetto, come nella lezione 9. La scaletta approvata prima di scrivere resta il punto in cui si cambia rotta a poco prezzo.

I vostri documenti come fonte

Appunti e materiali

Fate leggere all'agente i vostri appunti o le vostre schede e chiedete una lezione che resta fedele a quelli. È la logica delle fonti della lezione 5: niente invenzioni.

Skill app-interattiva

Animazioni e simulazioni

Si parte dall'intento didattico: che cosa deve capire lo studente manipolando la cosa? Si approva l'interazione in una frase, poi si scrive il codice.

Salvate prima di un cambiamento grande. «Salva il lavoro» e poi chiedete: se il risultato non convince, si torna indietro (lezione 3).

Un nuovo tipo di interazione tocca il motore: la skill nuovo-componente esiste, ma è una scelta consapevole e di solito non serve.

Continuare il lavoro04
Lezione 10 · Personalizzare e pubblicare
Checklist · 1 di 3 · correttezza e pedagogia

Prima si controlla che sia giusto, e che servaL'agente scrive bene anche quando sbaglia: la responsabilità del contenuto è vostra (lezioni 1 e 7).

1 · Correttezza disciplinare
  • Definizioni, enunciati, date e numeri sono veri, controllati su una fonte vostra.
  • La risposta segnata come giusta lo è. Provata, non supposta.
  • Esempi e citazioni esistono davvero: nulla è inventato per far quadrare.
  • Il linguaggio è quello che usate in classe, non una variante approssimata.
2 · Pedagogia
  • L'obiettivo della scheda si raggiunge davvero con la sequenza dei passi.
  • Gli errori proposti sono quelli tipici degli studenti, non facili da scartare.
  • Il feedback spiega il perché, non dice solo «giusto» o «sbagliato».
  • L'attività non è una prova: non assegna voti né classifica gli studenti.

Si prova da studenti. Rispondete giusto e sbagliato a ogni domanda, in ordine e fuori ordine: molti errori si vedono solo così.

Checklist · correttezza e pedagogia05
Lezione 10 · Personalizzare e pubblicare
Checklist · 2 di 3 · privacy e copyright

Che cosa può uscire, e che cosa non è vostroUn sito pubblicato lo vede chiunque abbia il link. Ciò che ci mettete va controllato prima, non dopo.

3 · Privacy
  • Nessun dato di studenti: nomi, voti, cognomi nei testi, negli esempi, nei file.
  • Nessun materiale riservato della scuola (documenti, circolari, PDP).
  • Sapete chi vede l'IP dei visitatori: GitHub e, solo dove servono, jsDelivr e cdnjs. L'elenco sta nel README di Geode, utile se la scuola chiede un'informativa.
  • I progressi restano nel browser dello studente: voi non li ricevete.
4 · Copyright
  • Testi, immagini, formule e schemi: sono vostri, liberi o citati con la fonte?
  • Un brano del manuale resta copiato anche se l'agente lo ha riscritto.
  • Immagini prese dal web: licenza controllata, autore indicato.
  • Le fonti usate sono nominate nella lezione, come nella lezione 5.

Una cosa che si dimentica: il nome e l'email con cui l'agente firma i salvataggi (lezione 9) stanno nella storia del progetto, che online è pubblica. Controllate quali avete impostato, prima di pubblicare.

Checklist · privacy e copyright06
Lezione 10 · Personalizzare e pubblicare
Checklist · 3 di 3 · accessibilità, e chi la fa

Che tutti possano usarla, e un secondo paio d'occhiUna lezione interattiva che non si legge o non si usa esclude proprio chi ne aveva più bisogno.

5 · Accessibilità
  • Contrasto sufficiente fra testo e sfondo, anche con il tema scelto.
  • Ogni immagine ha un testo alternativo che dice che cosa mostra: ![descrizione](file.png).
  • Si naviga con la sola tastiera (Tab, Invio): provate senza mouse.
  • Il colore non è l'unico segnale (giusto/sbagliato, legende).
  • Un'animazione o uno slider hanno anche una spiegazione scritta.
Far fare all'agente la prima rilettura
Rileggi la lezione «…» con questa checklist (correttezza, pedagogia, privacy, copyright, accessibilità). Elenca i problemi che trovi, con il passo e il motivo. Non correggere niente: decido io.

L'agente segnala, voi decidete. Non vede l'aula, non conosce i vostri studenti e può sbagliare anche nel giudicare: è un secondo controllo, non il primo.

Checklist · accessibilità07
Lezione 10 · Personalizzare e pubblicare
Checklist · da stampare

Cinque controlli, una paginaSi passa su ogni lezione prima di mostrarla agli studenti o di metterla online. Una spunta per riga, quando l'avete verificato voi.

1

Correttezza

  • Fatti e numeri controllati su fonte
  • Risposte giuste provate
  • Nulla di inventato
2

Pedagogia

  • L'obiettivo si raggiunge
  • Errori tipici, feedback con il perché
  • Non è una prova
3

Privacy

  • Nessun dato di studenti
  • Nessun materiale riservato
  • Email dei salvataggi controllata
4

Copyright

  • Testi e immagini: vostri o con licenza
  • Fonti nominate
  • Niente brani copiati
5

Accessibilità

  • Contrasto e testo alternativo
  • Si usa con la tastiera
  • Il colore non basta da solo
Alla fine

Provata da studente

  • Passata dall'inizio alla fine
  • Con almeno una risposta sbagliata
  • Vista anche su telefono
Checklist · una pagina08
Lezione 10 · Personalizzare e pubblicare
Pubblicare · 3 minuti

Pubblicare è una scelta, e il sito diventa pubblicoGitHub Pages gratuito non ha siti privati. Chi non pubblica non ha perso niente.

Se pubblicate

Il sito ha un indirizzo che chiunque può aprire

  • L'indirizzo è https://<utente>.github.io/<nome>/: il nome utente di GitHub compare nel link.
  • Il progetto su GitHub è pubblico: anche i file delle lezioni e la storia dei salvataggi si possono leggere.
  • Ciò che è online può essere copiato e salvato da altri.
  • Gli studenti aprono un link e basta: nessun account.
Se non pubblicate

Il sito resta sul vostro computer

  • Lo mostrate in anteprima, dal vostro computer.
  • Nessun account da creare, nessun dato che esce.
  • Potete decidere in qualsiasi momento: più avanti, con più calma.
  • La checklist vale lo stesso: la qualità non dipende dall'indirizzo.

Prima di dire sì pensate a chi può trovare il link e a che cosa c'è dentro. Con la checklist passata, nessun dato di studenti e le fonti nominate, pubblicare è ragionevole; altrimenti no.

Pubblicare · una scelta09
Lezione 10 · Personalizzare e pubblicare
Pubblicare · 2 minuti

Che cosa serve, e un permesso che non si saltaLa skill pubblica guida i passi. Voi mettete l'account e confermate nel browser.

Che cosaA che cosa serveCome
Account GitHubOspita il progetto e il sitoGratuito, su github.com. Il nome utente compare nell'indirizzo del sito
GitHub CLI (gh)Lo strumento con cui l'agente parla con GitHubSe manca, l'agente guida l'installazione (istruzioni in docs/SETUP.md)
L'accesso dal browserAutorizza il computer a operare sul vostro accountgh auth login -s workflow: si apre il browser, o compare un codice da inserire in una pagina
Il permesso workflowIl sito contiene i file che lo pubblicano. Senza, GitHub rifiuta di riceverliSe eravate già collegati senza: gh auth refresh -h github.com -s workflow

Leggete che cosa autorizzate. È un permesso dato a un programma sul vostro account: lo concedete voi, nel browser, dopo aver letto la richiesta (lezione 3).

Pubblicare · che cosa serve10
Lezione 10 · Personalizzare e pubblicare
Dimostrazione · 5 minuti

La pubblicazione, passo per passoSi guarda la skill pubblica lavorare. Si noti dove l'agente si ferma a chiedere.

1

Salva

Se c'è lavoro non salvato, propone di salvarlo prima.

→
2

Strumenti e accesso

Controlla gh e l'accesso, con il permesso workflow.

Voi nel browser
→
3

Corsi dimostrativi

Chiede se benvenuto, esempio-matematica ed esempi devono andare online.

Decidete voi
→
4

Nome e consenso

Propone il nome, mostra l'indirizzo e chiede il sì esplicito: è pubblico.

Decidete voi
→
5

Online

Crea il progetto su GitHub, attiva Pages e dopo circa due minuti dà il link.

Da notare: l'agente non pubblica mai da solo e non decide al posto vostro. I punti 2, 3 e 4 sono quelli in cui si ferma: se non vi chiede il consenso sul punto 4, fermatelo voi.

Si guarda la skill pubblica di Geode11
Lezione 10 · Personalizzare e pubblicare
Pubblicare · se qualcosa non va

Quattro intoppi, e che cosa fareQuasi sempre basta incollare il messaggio all'agente. Ma è bene sapere che cosa significa.

Che cosa succedeChe cosa significaChe cosa fare
Il caricamento è rifiutato: «without workflow scope»Manca il permesso workflowgh auth refresh -h github.com -s workflow, conferma nel browser, poi si ripete. Se il progetto online è già nato vuoto, non si ricrea
Il caricamento è rifiutato per autenticazioneL'accesso è scaduto o non è fattoSi rifà gh auth login -s workflow e si controlla con gh auth status
Il sito non compare dopo qualche minutoLa pubblicazione automatica si è fermataL'agente guarda l'ultima esecuzione (gh run list). L'errore tipico è una lezione che non compila: si riproduce in locale e si corregge
«Pages già attivo» (errore 409)È già stato fattoVa bene così, non serve altro

Rete della scuola: GitHub deve poter uscire. Se non ci si connette, provate un'altra rete (hotspot del telefono) e ditelo all'agente.

Pubblicare · se va storto12
Lezione 10 · Personalizzare e pubblicare
Dopo la pubblicazione · 3 minuti

Aggiornare il sito, aggiornare la piattaformaSono due cose diverse e si chiedono in modo diverso.

Le vostre modifiche

«Aggiorna il sito»

  • Prima si salva il lavoro, poi l'agente lo spinge online (skill pubblica).
  • Il sito si aggiorna da solo in circa un minuto: nessun'altra azione.
  • I progressi degli studenti non si cancellano, a patto di non cambiare mai storage_prefix in site.yaml.
Le novità di Geode

«Aggiorna la piattaforma»

  • Skill aggiorna: porta le novità del motore senza toccare corsi, lezioni e grafica.
  • Prima salva, poi mostra che cosa cambierebbe e chiede il vostro ok.
  • Alla fine controlla che i corsi si compilino ancora e vi racconta le novità.
  • Per portarle online, serve poi «aggiorna il sito».

Se i vostri lavori toccano file del motore (per esempio un nuovo componente), l'aggiornamento può trovare un conflitto: lo segnala e non sovrascrive niente. Fermatevi e chiedete all'agente di spiegarlo in termini di risultato, non di codice.

Aggiornamenti13
Lezione 10 · Personalizzare e pubblicare
Laboratorio · 20 minuti · al computer, da soli

Rifinire, controllare, e se volete pubblicareIl percorso A è per tutti. Il percorso B solo per chi decide di mettere il sito online.

A · 5 min

Rifinire. Cambiate almeno una cosa dell'aspetto o dei testi, chiedendola all'agente. Se serve, aggiungete un passo o una nuova lezione dalle vostre note.

A · 8 min

Checklist. Passate la vostra lezione sui cinque controlli. Chiedete all'agente la prima rilettura, poi verificate voi i punti che segnala.

A · 2 min

Salvate. «Salva il lavoro»: la frase del salvataggio deve dire quello che avete fatto.

B · 5 min

Pubblicare (facoltativo). Solo se la checklist è passata e avete l'account. Dite all'agente «voglio pubblicare il sito» e leggete ogni richiesta prima di rispondere.

Non avere pubblicato non è un fallimento. Chi resta in locale ha un sito controllato e sa come si fa: è l'obiettivo dell'ora. Nessun dato di studenti, nemmeno negli esempi.

Consegna su Classroom: lezione-10-lab-pubblicazione.md14
Lezione 10 · Personalizzare e pubblicare
Chiusura · conservare il progetto

Il progetto è la cartella, e si riprende da lìTutto ciò che serve per ripartire sta in una cartella del vostro computer.

Dove sta

Una cartella, vostra

Corsi, lezioni, configurazione e storia dei salvataggi. Sapete dove si trova e come si chiama, e ne tenete una copia su un altro supporto (disco esterno o spazio personale online).

Come si riprende

Si riapre e si dice che cosa si vuole

Aprite la cartella nell'assistente. L'agente rilegge AGENTS.md e le skill: ricorda il progetto, non la conversazione di quel giorno.

Con quale cadenza

Salvate, controllate, poi decidete

Un salvataggio dopo ogni passo che vi soddisfa, la checklist prima di mostrare, la pubblicazione quando ne siete convinti.

Se cambia l'assistente (un piano che finisce, un altro prodotto): la cartella resta e la leggono tutti e tre, perché le istruzioni sono in AGENTS.md e nelle skill (lezione 9). Si perde solo la conversazione.

Chiusura · conservare15
Lezione 10 · Personalizzare e pubblicare
Chiusura del corso · il filo

Dieci lezioni, un metodoOgni lezione ha aggiunto un controllo. Alla fine sono quelli che usate anche per decidere se pubblicare.

LezioniChe cosa ha insegnatoIl controllo che resta
1 · 2Chat e agente: che cosa sono, come si accedeLimiti, allucinazioni, responsabilità vostra
3 · 4Far lavorare l'agente sui file; il contesto permanentePermessi, backup, dati personali
5 · 6 · 7Fonti, skill, verificheCitazioni, copyright, valutazione assistita
8 · 9Dal piano al sito: motore, contenuti, salvataggiServizi esterni, comandi eseguiti dall'agente
10Personalizzare e pubblicareChecklist e permessi concessi a GitHub

Il metodo è sempre lo stesso: si dà un obiettivo preciso, l'agente propone, voi controllate e correggete, poi decidete che cosa fare del risultato.

Chiusura · il filo16
Lezione 10 · Personalizzare e pubblicare
Chiusura

Quattro cose da portare a casa

  1. Personalizzare è chiedere, e il motore non si tocca. Aspetto, testi e ordine dei corsi sono vostri; le novità della piattaforma arrivano con la skill aggiorna.
  2. Prima la checklist, poi la decisione. Correttezza, pedagogia, privacy, copyright, accessibilità: l'agente segnala, voi verificate.
  3. Pubblicare è una scelta, e un sito pubblicato è pubblico. Serve l'account, gh e il permesso workflow; non pubblicare non è un fallimento.
  4. Il progetto è la vostra cartella. Si riapre nell'assistente, qualunque esso sia, e si riparte da dove eravate.

Da dove ripartire. Una lezione sola, della vostra materia, provata con una classe. Poi un'altra. Il corso è finito: il vostro sito comincia adesso.

Chiusura17