Premi P per entrare in modalità presentazione · frecce/spazio per avanzare · Esc per uscire
100%
Lezione 5 · Knowledge base e fonti
Dalla IA generativa alla IA agentica · Lezione 5

Knowledge base:
file, wiki e RAG

Nell'ora 4 avete scritto chi siete. Oggi mettete in ordine le fonti della vostra disciplina, in modo che l'agente le trovi da solo e vi dica sempre da dove ha preso quello che dice.

DestinatariDocenti di scuola superiore
ServeTre-cinque fonti della vostra materia
DurataUn'ora, pausa compresa
Modulo5 di 10
Corso agenti IA01
Lezione 5 · Knowledge base e fonti
Obiettivi e mappa

Alla fine di quest'oraIl profilo dell'ora 4 dice all'agente come lavorate. Adesso gli diamo il materiale su cui lavorare.

  1. Avete una piccola knowledge base della vostra materia Poche fonti scelte da voi, un indice che le tiene insieme e pagine di sintesi che citano sempre la fonte.
  2. Sapete quando servono file navigabili e quando serve un sistema RAG Conoscete la differenza fra le due soluzioni e sapete che cosa ci guadagnate e che cosa ci perdete scegliendo l'una o l'altra.
10 min

Le fonti

Raccogliere, scegliere, scrivere file che l'agente sa leggere

12 min

La wiki

Indice, pagine, fonti. Una wiki vera, navigata dall'agente

10 min

File o RAG

Due modi di dare conoscenza. Citazioni e copyright

20 min

Laboratorio

L'agente monta la vostra wiki partendo da una descrizione

Obiettivi e mappa02
Lezione 5 · Knowledge base e fonti
Il punto di partenza

Le fonti della vostra materia sono già tutte sul computerIl problema non riguarda il procurarsele. Riguarda il fatto che nessuno le ha mai messe in un posto solo, e che l'agente da solo non sa dove guardare.

Come stanno oggi
  • Le slide di un corso di aggiornamento, in una cartella Download
  • Tre PDF di normativa, allegati a una vecchia mail
  • Gli appunti presi a mano su un manuale
  • Un articolo salvato fra i preferiti del browser
  • Quello che ricordate e che non avete scritto da nessuna parte
Che cosa serve all'agente
  • Una cartella sola, con dentro le fonti che contano
  • Un indice che dica che cosa c'è e dove sta
  • Pagine di sintesi che l'agente può leggere in fretta
  • Il collegamento fra ogni sintesi e la fonte da cui viene

Una knowledge base è questo e niente di più. È una cartella di file di testo, organizzata in modo che l'agente ci si muova da solo. Non serve un programma particolare e non serve saper programmare.

Il punto di partenza03
Lezione 5 · Knowledge base e fonti
Raccolta e selezione

Poche fonti scelte valgono più di una cartella pienaVale qui la stessa regola dell'ora 4. Lo spazio di lettura dell'agente è una risorsa finita, e selezionare è il vostro lavoro.

  1. Scegliete le fonti che usereste davvero con un collega nuovo Cinque fonti che conoscete bene sono migliori di cinquanta che non avete letto. Le altre si aggiungono strada facendo, una alla volta.
  2. Tenete le fonti separate dalle sintesi Le fonti stanno in una cartella e non si toccano mai. Le sintesi stanno in un'altra cartella e le scrive l'agente.
  3. Preferite i formati che l'agente legge senza fatica Il testo semplice e il Markdown si leggono sempre. Un PDF fatto di scansioni è un'immagine, e va convertito prima di metterlo nella raccolta.
  4. Scrivete accanto a ogni fonte da dove viene Servono il titolo, l'autore, l'anno e il collegamento. Servono a voi per citare e servono all'agente per dirvi su che cosa si sta basando.
Raccolta e selezione04
Lezione 5 · Knowledge base e fonti
Come si scrive un file

Un file scritto bene si legge due volteLo leggete voi e lo legge l'agente. Le stesse quattro accortezze funzionano per tutti e due.

Una riga, un caso

Ogni riga descrive una cosa sola. Se una riga contiene due informazioni diverse, conviene spezzarla in due.

Intestazioni esplicite

I titoli dicono che cosa c'è sotto. L'agente li usa per decidere quale pezzo del file gli serve davvero.

Valori da un elenco chiuso

Dove è possibile, scegliete i valori da una lista breve e dichiarata. Così non dovete spiegarli ogni volta.

Convenzioni dichiarate una volta

Le date, i separatori e le abbreviazioni si spiegano in un punto solo, e poi valgono per tutto il materiale.

pagine/tassonomia-di-bloom.md--- titolo: Tassonomia di Bloom, LOTS e HOTS tipo: concetto fonti: [fonti/Blooms Taxonomy.pdf] tag: [obiettivi, verifica] aggiornato: 2026-03-14 --- # Tassonomia di Bloom Le sei categorie, dalla più semplice alla più complessa: ricordare, comprendere, applicare, analizzare, valutare, creare. ## Collegamenti [[obiettivo-di-apprendimento]] [[progettazione-a-ritroso]]

Le righe fra i due --- sono la scheda della pagina. L'agente le legge per capire di che tipo di pagina si tratta e da quale fonte viene, senza aprire tutto il resto.

Come si scrive un file05
Lezione 5 · Knowledge base e fonti
L'impianto

Una knowledge base ha tre livelliQuesto impianto lo ha descritto Andrej Karpathy in un testo di due pagine. La divisione dei ruoli è netta: voi scegliete le fonti e fate le domande, l'agente scrive e tiene in ordine le pagine.

1fonti/ I materiali originali: i PDF dei corsi, la normativa, gli articoli, i vostri appunti. L'agente li legge soltanto. Non li modifica, non li rinomina e non li sposta mai. Li curate voi.
2pagine/ Le pagine di sintesi e le voci trasversali, scritte in Markdown. Ogni pagina dichiara da quale fonte viene e rimanda alle pagine collegate. Le scrive l'agente.
3AGENTS.md Lo schema della wiki. Spiega com'è fatta, quali sono le convenzioni e che cosa fare quando si aggiunge una fonte o si risponde a una domanda. Lo scrive l'agente e voi lo correggete.

Lo schema è lo stesso file-guida dell'ora 4. Qui contiene le regole di manutenzione della wiki, e trasforma l'agente in un archivista che lavora sempre allo stesso modo.

Due file di servizio completano l'impianto. index.md dice che cosa c'è nella wiki. log.md tiene il diario di quello che è stato fatto, con la data.

L'impianto06
Lezione 5 · Knowledge base e fonti
Indice e collegamenti

L'agente scende per gradi fino alla fonteNon legge tutta la wiki a ogni domanda. Parte dall'indice, sceglie la pagina che serve e arriva alla fonte soltanto quando la risposta richiede il dettaglio.

Primo passo
index.md

Il catalogo di tutte le pagine, diviso per tipo. Ogni voce ha un titolo, un collegamento e una riga di riassunto. L'agente lo legge per primo e capisce dove andare.

→
Secondo passo
pagine/bics-e-calp.md

La pagina che risponde. Contiene la sintesi già fatta, i collegamenti alle pagine vicine e il rimando alla fonte da cui deriva.

→
Terzo passo, se serve
fonti/2024 CLIL/

Il materiale originale. L'agente lo apre quando deve verificare un passaggio o citarlo con precisione, e vi dice che lo sta facendo.

Per questo l'indice conta più di tutto il resto. Se una pagina non compare nell'indice, per l'agente è come se non esistesse.

Ogni passo resta visibile. Vedete quali file l'agente apre e potete controllare che la risposta venga davvero da lì.

Indice e collegamenti07
Lezione 5 · Knowledge base e fonti
Dimostrazione · una wiki vera

Guardiamo l'agente percorrere una wikiApro una wiki didattica costruita così: una quarantina di pagine, una manciata di fonti, un indice. Faccio una domanda e seguiamo insieme la strada che fa.

La domanda
Devo spiegare a un collega la differenza fra BICS e CALP e perché conta quando si valuta in CLIL. Rispondimi in dieci righe e dimmi da quali pagine e da quali fonti hai preso ogni cosa.
Da guardare

L'agente apre index.md prima di ogni altra cosa. Dall'indice sceglie due o tre pagine e lascia perdere tutte le altre.

Da guardare

La risposta cita i file. Apriamone uno insieme e controlliamo che ci sia scritto davvero quello che l'agente riporta.

Da guardare

Chiedo di archiviare la risposta come pagina nuova. La wiki cresce anche con le domande, non soltanto con le fonti.

La cosa da notare è la velocità con cui scarta. Su quaranta pagine ne apre tre. Il lavoro di selezione lo ha fatto l'indice, e l'indice lo ha scritto l'agente quando avete aggiunto le fonti.

Dimostrazione · navigare la wiki08
Lezione 5 · Knowledge base e fonti
Come si tiene viva

Con la wiki si fanno tre coseSono tre operazioni che si chiedono a parole. Conviene scriverle nello schema una volta sola, così l'agente le esegue sempre allo stesso modo.

Aggiungere una fonte

Ingest

Mettete un materiale nella cartella delle fonti e lo dite all'agente. Lui lo legge, discute con voi i punti principali, scrive la pagina di sintesi, aggiorna le pagine collegate e ritocca l'indice.

Una fonte alla volta. Voi leggete quello che ha scritto e correggete prima di passare alla successiva.

Fare una domanda

Query

Chiedete qualcosa alla wiki. L'agente cerca le pagine pertinenti, le legge e risponde citando i file.

Le risposte buone si archiviano. Un confronto o una sintesi che vi servirà ancora diventa una pagina nuova, invece di restare nella conversazione.

Controllare la salute

Lint

Ogni tanto chiedete all'agente di rileggere tutto e di segnalare i problemi: le pagine che si contraddicono, le affermazioni superate da una fonte nuova, le pagine che nessuno collega, le sintesi senza fonte.

È la manutenzione che di solito nessuno fa.

Qui sta la differenza con una cartella di PDF. La sintesi si fa una volta e poi si aggiorna. Ogni fonte che aggiungete migliora anche le pagine che c'erano già, invece di restare accanto a loro senza toccarle.

Ingest, query, lint09
Lezione 5 · Knowledge base e fonti
Due modi di dare conoscenza

I file navigabili e il RAG risolvono lo stesso problemaIl problema è dare all'agente una conoscenza che non ha. Cambia chi decide che cosa leggere, e cambia quanto potete controllarlo.

File navigabiliRAG
Chi sceglie che cosa leggere L'agente, seguendo l'indice e i collegamenti che avete davanti Un componente automatico, prima che l'agente entri in gioco
Che cosa arriva nel contesto Le pagine intere che l'agente ha deciso di aprire I pezzi di documento che il sistema giudica simili alla domanda
Che cosa vedete voi Ogni file aperto, uno per uno. Potete aprirlo anche voi e controllare La risposta e i riferimenti. Il criterio di selezione resta nascosto
Che cosa si accumula Le sintesi e i collegamenti restano scritti e migliorano nel tempo Niente. Ogni domanda riparte dai documenti originali
Quando conviene Poche decine o poche centinaia di documenti, curati da voi Migliaia di documenti, oppure un archivio che cambia in continuazione

Le due strade non si escludono. Un agente può usare un sistema RAG come una delle sue fonti, e una wiki può nascere dalle risposte che il RAG ha dato.

File navigabili e RAG10
Lezione 5 · Knowledge base e fonti
Un esempio di RAG

NotebookLM funziona cosìLo guardiamo da fuori, senza laboratorio. Molti di voi lo usano già ed è l'esempio più vicino di sistema RAG pronto all'uso.

Schermata di NotebookLM con trentanove fonti caricate, la chat al centro e il pannello Studio a destra 1 2 3
1Le fonti caricate. Qui ce ne sono trentanove, raggruppate per argomento.
2La chat. Le risposte citano il punto esatto del documento.
3Lo Studio. Dalle stesse fonti genera mappe, quiz, report e infografiche.
Che cosa fa bene
  • Carica molti documenti in pochi minuti
  • Risponde citando il punto esatto del documento
  • Trasforma le fonti in mappe, quiz e riassunti
Che cosa non fa
  • Non costruisce nulla che resti fra una domanda e l'altra
  • Non vi avverte quando due fonti si contraddicono
  • Non lavora nella cartella dove tenete i materiali

Un uso ragionevole tiene insieme le due cose. NotebookLM serve per esplorare in fretta un materiale nuovo. La wiki serve per conservare quello che avete capito, in una forma che l'agente riusa nelle ore successive.

NotebookLM11
Lezione 5 · Knowledge base e fonti
Sicurezza applicata

La knowledge base non rende vere le fonti che contieneUna sintesi scritta bene sembra affidabile anche quando la fonte non lo è. La responsabilità di scegliere le fonti resta vostra.

Qualità

Che cosa entra

  • Preferite le fonti che potete attribuire a un autore e a una data
  • Segnalate nel file le fonti di cui non siete sicuri
  • Tenete la normativa nella versione ufficiale, non in un riassunto trovato in rete
Citazioni

Da dove viene

  • Chiedete sempre la citazione del file, anche quando la risposta vi convince
  • Aprite la fonte e controllate, almeno a campione
  • Se una frase non ha una fonte, chiedete all'agente da dove l'ha presa
Copyright

Che cosa esce

  • Un manuale a stampa si tiene per studio personale e non si ridistribuisce
  • Nei materiali per la classe mettete la citazione, non il testo copiato
  • Le immagini prese in rete hanno una licenza, e va guardata prima di usarle

Scrivete nello schema della wiki la regola sulle citazioni. Per esempio: «In ogni risposta cita i file da cui hai preso le informazioni. Se una cosa non la trovi nelle pagine o nelle fonti, dillo invece di rispondere lo stesso.»

Fonti, citazioni, copyright12
Lezione 5 · Knowledge base e fonti
La prova che conta

Fate una domanda la cui risposta non sta nelle fontiÈ il solo modo per scoprire se la vostra knowledge base vi protegge dall'invenzione vista nell'ora 4, oppure se vi lascia esposti come prima.

La domanda di controllo
Nelle mie fonti, che cosa si dice sulla valutazione delle competenze digitali degli studenti? Se non c'è, dimmelo.
Risposta buona

L'agente dice che nelle pagine e nelle fonti quell'argomento non c'è, e vi propone di cercare una fonte che lo copra.

Risposta da correggere

L'agente risponde lo stesso, con affermazioni ragionevoli e nessuna citazione. Sono le sue conoscenze generali, presentate come se venissero dalle vostre fonti.

Che cosa fare quando succede

  • Aggiungete allo schema la regola sulle citazioni e la richiesta esplicita di segnalare i buchi.
  • Ripetete la stessa domanda in una sessione nuova e controllate se la risposta cambia.
  • Tenete la domanda di controllo da parte. Vi servirà ogni volta che aggiungerete fonti nuove.

Questa è la stessa verifica dell'ora 4, spostata dalle regole alle fonti. Un vuoto nella knowledge base si comporta come un vuoto nel file-guida.

La domanda di controllo13
Lezione 5 · Knowledge base e fonti
Laboratorio · 20 minuti · da soli, al computer

Una descrizione, e l'agente costruisceLa struttura della wiki non la decidete voi. Date all'agente il testo di Karpathy e il vostro argomento, e lui prepara cartelle, schema e indice.

Da incollare, con il vostro argomento al posto della parentesi
Leggi questo testo: https://gist.githubusercontent.com/karpathy/442a6bf555914893e9891c11519de94f/raw/ac46de1ad27f92b28ac95459c782c07f6b8c964a/llm-wiki.md Descrive un modo di costruire una knowledge base mantenuta da un agente. Seguendo quelle linee guida, prepara in questa cartella la mia wiki su [argomento]. Crea le cartelle, scrivi il file-guida con le convenzioni e le operazioni, e crea l'indice e il registro. Poi spiegami in poche righe le scelte che hai fatto.
3 min

Create una cartella vuota, apritela con l'agente e metteteci dentro le vostre tre-cinque fonti.

7 min

Incollate il prompt. Leggete il file-guida che l'agente ha scritto e correggetelo dove non vi convince.

10 min

Chiedete di ingerire le fonti una alla volta. Poi fate una domanda vera e la domanda di controllo della slide precedente.

Da controllare alla fine: il file-guida spiega ingest, query e lint? Ogni pagina cita la sua fonte? L'indice le elenca tutte? Alla domanda di controllo l'agente ha ammesso di non sapere?

Chi arriva senza materiale trova su Classroom un pacchetto di fonti di didattica trasversale, adatto a qualunque disciplina.

Consegna su Classroom lezione-05-lab-knowledge-base.md14
Lezione 5 · Knowledge base e fonti
Chiusura

Quattro cose da portare a casa

  1. Una buona descrizione vale come un progetto. La vostra wiki l'ha montata l'agente a partire da due pagine di testo scritte da qualcun altro. Voi avete scelto l'argomento e le fonti.
  2. L'indice fa il lavoro più importante. L'agente parte da lì, scende alla pagina e poi alla fonte. Una pagina fuori dall'indice non viene mai letta.
  3. La sintesi si fa una volta e poi si mantiene. Ogni fonte nuova migliora anche le pagine vecchie. Un sistema RAG invece ricomincia da capo a ogni domanda.
  4. Le citazioni sono la vostra garanzia. Chiedetele sempre e controllatele a campione. La domanda di controllo vi dice se l'agente sta inventando.

A casa, se volete, aggiungete una fonte sola. Guardate quante pagine l'agente tocca per sistemarla e se vi segnala qualcosa che contraddice quello che c'era già. Il testo di Karpathy sta nella consegna.

Prossima ora: le skill. Adesso l'agente sa chi siete e conosce le vostre fonti. Nell'ora 6 gli insegnate una procedura, che poi richiama da solo quando serve.

Chiusura15