Lezione gratuita

Definire un portale privato e un risultato verificabile

Definire un portale privato e un risultato verificabile — Creare e consegnare un piccolo portale AI privato. Un caso d’uso limitato; Documenti didattici con proprietari; Un contratto prima della pagina. Esercitazione pratica: Definire un portale privato e un risultato verificabile.

Versione demo. I materiali sono in fase di revisione editoriale.

Argomenti trattati

  • Un caso d’uso limitato
  • Documenti didattici con proprietari
  • Un contratto prima della pagina

Un caso d’uso limitato

Costruiamo un portale didattico privato: due utenti vedono documenti autorizzati e fanno domande sul testo. Browser mostra risposte/fonti, backend controlla accesso, adapter modello è separato. Il primo è uno stub deterministico locale che estrae testo, non LLM. Verifica tutto senza API pagate o pesi grandi. Mostra stub-extractive senza dichiarare modello AI funzionante. Sostituirlo richiede decisioni separate su risorse, dati e valutazione. Scope read-only senza upload, posta, pagamenti o shell. Ascolto soltanto 127.0.0.1. Alice ottiene risposta autorizzata con fonte ma non documento Bob neppure indovinandone ID. Nascondere link nel browser non autorizza accesso.

Documenti didattici con proprietari

Crea portal-lab/knowledge.json con fatti inglesi immaginari. Testi brevi consentono riferimenti manuali. returns appartiene ad Alice, budget a Bob, support a entrambi tramite shared. source è etichetta interna, non URL esterno; version lega risposte a una revisione. receipt trova returns autorizzato; payroll segnala fonti insufficienti. In un progetto reale modifica knowledge un operatore autorizzato, non un campo owner nel browser. Il file resta fuori public e non va servito per debug. La fixture insegna isolamento, non descrive negozi reali. Conserva l’originale per test evitando che cambiare quattordici giorni modifichi aspettative silenziosamente.

[
 {"id":"returns","owner":"alice","title":"Returns","version":1,"source":"training:returns-v1","text":"Returns require a receipt within 14 days."},
 {"id":"budget","owner":"bob","title":"Budget","version":1,"source":"training:budget-v1","text":"The internal budget is 500 units."},
 {"id":"support","owner":"shared","title":"Support","version":1,"source":"training:support-v1","text":"Support opens at 09:00."}
]

Un contratto prima della pagina

Specifica API: GET /healthz solo ok; GET /api/docs richiede credenziale e restituisce id/title/version/source visibili; POST /api/answer riceve question e docIds facoltativi. Senza credenziale401, ID ignoto o altrui ugualmente404, body eccessivo413. Risposte con status/text/citations/mode=stub-extractive. Citazioni solo da passaggi autorizzati recuperati, non stringhe arbitrarie. Mancano prove: insufficient_sources, senza inventare. / e /app.js statici senza knowledge possono aprirsi prima dell’accesso. Il prototipo usa bearer privato inserito manualmente, senza localStorage. È meccanismo loopback didattico, non identity-provider pubblico. Backend deriva proprietario dalla credenziale, non dal body. Prima test del contratto, poi ampliamento.

Esercitazione pratica

Definire un portale privato e un risultato verificabile

Vai alla lezione

Programma del corso

  1. Definire un portale privato e un risultato verificabile
  2. Separare conoscenza, ricerca e adapter
  3. Verificare identità e accesso nel backend
  4. Collegare HTTP, browser e risposte con fonti
  5. Limiti, registri e avvio controllato
  6. Test d’integrazione, ripristino e consegna