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