Lezione gratuita

Definire i confini e creare l’interfaccia

Definire i confini e creare l’interfaccia — Creare una chat AI locale. Fissare l’endpoint sul server; Salvare index.html; Definire stati osservabili. Esercitazione pratica: Prove del laboratorio.

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

Argomenti trattati

  • Fissare l’endpoint sul server
  • Salvare index.html
  • Definire stati osservabili

Fissare l’endpoint sul server

Il browser chiama /api/chat sulla stessa origine. Solo Node contatta 127.0.0.1:11434. Non inoltrare URL arbitrari forniti dai visitatori.

Il browser mostra messaggi, il server valida richieste e Ollama genera testo. Separa i ruoli per impedire al browser di scegliere endpoint arbitrari o leggere file server. Usa domande sintetiche sul laboratorio. La risposta è testo generato, non consiglio verificato. Il confine locale riduce trasferimenti esterni ma non protegge da tutti gli utenti locali, estensioni o integrazioni configurate.

Salvare index.html

Crea un campo etichettato e comandi stop/clear. La risposta sarà testo semplice. Il campione tecnico condiviso usa un’interfaccia inglese.

L’indirizzo upstream non compare nel JSON della richiesta, evitando un fetcher di URL arbitrari. In futuro puoi offrire modelli consentiti, ma il server deve associare nomi affidabili a configurazioni fisse anziché ricevere URL completi dal browser.

Crea i file indicati in una cartella ed esegui Node da lì. Modello ed endpoint sono fissati sul server. Prima dello streaming valida input e stato upstream; dopo l’avvio comunica errori nel flusso o con stato interrotto visibile. Distingui limiti di byte, messaggi e contesto: controllano risorse diverse. Provali separatamente conservando la richiesta che riproduce il rifiuto.

<!doctype html><html lang="en"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Local chat lab</title><style>body{font:1.1rem/1.6 system-ui;max-width:55rem;margin:2rem auto;padding:1rem}textarea{width:100%;font:inherit}pre{white-space:pre-wrap;overflow-wrap:anywhere}button{font:inherit;margin:.3rem}:focus-visible{outline:3px solid #9b4300}</style><main><h1>Local chat lab</h1><p>Generated answers can be wrong. Synthetic data only.</p><form id="chat"><label for="prompt">Message</label><textarea id="prompt" maxlength="2000" required></textarea><button id="send">Send</button></form><button id="stop" type="button">Stop</button><button id="clear" type="button">Clear session</button><p id="status" role="status"></p><div id="log"></div></main><script src="app.js" defer></script></html>

Definire stati osservabili

Prevedi idle, receiving, complete, interrupted e failed. Disabilitare Send evita doppi clic durante il flusso; servono comunque limiti server.

Prova risposta riuscita, servizio fermo, interruzione e input eccessivo. Mantieni il testo incompleto come parziale. La cronologia vive nella memoria dell’interfaccia e può essere svuotata; ciò non cancella log del sistema o backup esterni. Prima di pubblicare aggiungi autenticazione, autorizzazione, TLS, quote, conservazione e monitoraggio. Una demo locale, anche gradevole, non dimostra l’esistenza di tali controlli.

Esercitazione pratica

Prove del laboratorio

Vai alla lezione

Programma del corso

  1. Definire i confini e creare l’interfaccia
  2. Servire un’applicazione locale limitata
  3. Inoltrare un flusso limitato
  4. Decodificare record nel browser
  5. Limitare sessioni, input e risorse
  6. Verificare l’app e pianificare deploy