Definire il contratto
Definire il contratto — LLM locali e JSON validato. Assenza esplicita; Scrivere schema.mjs; Creare casi limite. Esercitazione pratica: Prove del laboratorio.
Versione demo. I materiali sono in fase di revisione editoriale.
Argomenti trattati
- Assenza esplicita
- Scrivere schema.mjs
- Creare casi limite
Assenza esplicita
Usa null per data o capienza assenti. Zero indica una quantità dichiarata, non dati mancanti. Il titolo rimane obbligatorio.
Il record didattico descrive un laboratorio con titolo, data e capienza facoltativa. Definisci il significato dei campi prima dell’estrazione. Un’informazione assente deve restare assente: anche un numero formalmente valido può essere inventato. Conserva la fonte originale accanto al candidato affinché una persona possa verificare i valori senza fidarsi della spiegazione del modello o del tono sicuro della risposta.
Scrivere schema.mjs
Salva lo schema. I campi obbligatori devono comparire anche quando consentono null. Rifiutare proprietà aggiuntive aiuta a rilevare campi inventati.
Lo schema sceglie una politica: capienza nota intera positiva, sconosciuta null. Zero viene quindi rifiutato, non interpretato come assenza. Documenta la regola accanto al caso per distinguere un dato mancante da una capienza dichiarata ma non ammessa.
Lavora in una cartella separata e salva JavaScript in file .mjs da eseguire con Node. Mantieni schema e input identici nei confronti. La risposta HTTP è un involucro; il messaggio del modello è una seconda stringa da analizzare. Gestisci separatamente errori di parsing e validazione. Conserva le categorie nel rapporto per ricostruire la causa di uno scarto anche dopo esecuzioni successive.
export const schema = {type:'object',properties:{title:{type:'string'},date:{type:['string','null']},seats:{type:['integer','null'],minimum:1}},required:['title','date','seats'],additionalProperties:false};
Creare casi limite
Scrivi tre fonti: record completo, data assente e capienza contraddittoria. Registra le decisioni attese prima di chiamare il modello.
Superare lo schema conferma soltanto la struttura consentita. L’accettazione richiede anche confronto con la fonte e regole applicative. Separa record accettati, scartati e da rivedere. Non correggere date, valute o nomi indovinando. Un tentativo automatico fallito è utile alla revisione se conserva fonte ed errore. Lo stato deve spiegare la decisione anziché nascondere l’incertezza dietro un JSON ordinato.
// fixtures.mjs
// Fictional fixtures
export const cases=[{text:'Clay workshop, 2027-03-12, six seats.',expected:{title:'Clay workshop',date:'2027-03-12',seats:6}},{text:'Clay workshop, date not set.',expected:{title:'Clay workshop',date:null,seats:null}},{text:'Six seats. Correction: eight seats; approval unclear.',review:true}];
Esercitazione pratica
Prove del laboratorio
Vai alla lezione