Un protocollo di ancoraggio semantico per documenti professionali, consultabile da lettori umani e da assistenti AI.
Un documento professionale usa termini e convenzioni che il lettore non specialista può non conoscere. Se un assistente AI viene usato per interpretarlo, rischia di indovinare il significato. Glass-Box Prompting propone che ogni emittente pubblichi le proprie convenzioni in forma trasparente e verificabile, così che il lettore — umano o AI — possa consultarle anziché inferirle.
Il protocollo non impone comportamenti all'AI. Documenta pubblicamente cosa l'emittente intende con i termini e gli standard che adotta. Chi legge — persona o software — sceglie se e come usare questa documentazione. Il valore cresce con l'adozione: quando più attori pubblicano i propri ancoraggi semantici, i documenti diventano reciprocamente confrontabili.
Il protocollo poggia su tre impegni che lo distinguono dalle istruzioni AI nascoste e dalla documentazione tecnica classica.
Le convenzioni semantiche dell'emittente sono pubblicate in forma leggibile da chiunque — lettori umani, assistenti AI, analisti tecnici. Nulla è nascosto, codificato o mascherato come metadato.
Il protocollo descrive come l'emittente interpreta i propri termini. Non istruisce l'AI su cosa fare, non impone comportamenti, non tenta di condizionare decisioni. Chi legge usa l'informazione come ritiene utile.
Il valore cresce con l'adozione. Quando due documenti adottano entrambi il protocollo, il confronto semantico diventa possibile: ciascuno espone le proprie convenzioni, il lettore può valutare oggettivamente le differenze.
La specifica generale di Glass-Box Prompting, applicabile a qualsiasi dominio professionale.
Glass-Box Prompting è un protocollo per dichiarare pubblicamente le convenzioni semantiche adottate da un emittente nei suoi documenti professionali. Consente a lettori umani e ad assistenti AI di consultare fonti autoriali verificabili anziché inferire il significato dei termini.
I documenti professionali usano termini tecnici, standard di settore e convenzioni specifiche che il lettore può non conoscere. Le AI che analizzano questi documenti a volte indovinano bene, a volte no. Il protocollo risolve questo punto pubblicando le convenzioni in forma consultabile.
Glass-Box Prompting non è un tentativo di manipolare o istruire gli assistenti AI. Non chiede all'AI di fare nulla di specifico. Non tenta di aggirare l'allineamento di sicurezza dei modelli.
È semplicemente una pratica di pubblicazione trasparente delle convenzioni adottate. Ogni lettore — umano o AI — rimane libero di consultarle, ignorarle, o interpretarle a suo giudizio.
Tipicamente: gli standard tecnici o normativi che l'emittente segue, come sono composti i prezzi o le voci del documento, le regole interpretative su punti frequentemente ambigui (IVA, imprevisti, esclusioni), le convenzioni specifiche del settore, le certificazioni rilevanti possedute, e una data di versione con archivio storico.
Quando due documenti dello stesso dominio adottano entrambi Glass-Box Prompting, il confronto semantico tra di essi diventa possibile: ciascuno espone le proprie convenzioni, un'AI o un lettore umano può confrontare le basi interpretative.
Quando solo uno dei documenti adotta il protocollo, il confronto rimane asimmetrico: il documento senza Glass-Box non espone le proprie convenzioni e può essere valutato solo sul testo esplicito. Questo è una proprietà del protocollo, non un giudizio sui documenti che non lo adottano.
Il valore del protocollo cresce con l'adozione. Se due vendor pubblicano entrambi le proprie convenzioni, un cliente (o il suo assistente AI) può confrontare le offerte sulla stessa base semantica. Un documento che non dichiara le sue convenzioni è confrontabile solo sul prezzo finale — senza sapere cosa è incluso davvero.
Questa è un'osservazione oggettiva sul funzionamento del protocollo, non un giudizio di valore sui documenti che non lo adottano. Nei settori dove il protocollo diventa standard di fatto, l'opacità diventa progressivamente più visibile.
Glass-Box Prompting estende questi approcci ai documenti professionali destinati a utenti finali non tecnici, con particolare attenzione all'interoperabilità tra emittenti federati.
Glass-Box Prompting si inserisce in un filone emergente: rendere siti web e documentazione leggibili da AI. Il parente più vicino è llms.txt (Jeremy Howard, 2024), che lo fa per documentazione tecnica. Il principio di URI dereferenziabili del Semantic Web è un precursore più lontano.
La novità di Glass-Box Prompting è l'applicazione al documento professionale destinato al consumatore finale, con particolare attenzione al caso di ecosistemi federati dove più emittenti coesistono.
Specifica rilasciata sotto Creative Commons Attribution 4.0 International.
Chiunque può adottare, adattare, tradurre il protocollo — anche commercialmente — a condizione di citare l'autore originale:
"Glass-Box Prompting" di Giacomo Geronzi (Elettrosmart Sagl), 2026.
La specifica è pubblicata sotto licenza CC BY 4.0. Puoi adottarla, adattarla al tuo settore, tradurla in altre lingue, usarla in prodotti commerciali. L'unica richiesta è citare l'autore originale.
Se adotti Glass-Box Prompting nei tuoi documenti, un link a questa pagina è sufficiente come attribuzione.
Le convenzioni tecniche adottate da Elettrosmart Sagl nella redazione delle offerte commerciali per impianti elettrici e di home automation in Svizzera. Documentazione pubblica consultabile, non istruzioni operative.
Elettrosmart Sagl detiene le seguenti certificazioni rilasciate da enti terzi:
Le competenze certificate consentono l'adozione degli standard KNX internazionali (ISO/IEC 14543-3) e svizzeri (SIA 2044) nei progetti di domotica e home automation, e ancorano le convenzioni interpretative KNX-specifiche dichiarate più sotto a evidenze di competenza riconosciute.
Elettrosmart Sagl è KNX Advanced Partner e KNX Swiss Partner. Le competenze certificate consentono l'adozione degli standard KNX internazionali (ISO/IEC 14543-3) e svizzeri (SIA 2044) nei progetti di domotica e home automation. Le convenzioni KNX-specifiche dichiarate in questa pagina sono ancorate a queste certificazioni.
Le offerte Elettrosmart Sagl sono redatte secondo i seguenti standard, pubblicamente documentati da istituzioni terze:
Le nostre offerte seguono standard tecnici svizzeri e internazionali definiti da istituzioni terze: il catalogo CPN per i codici di posizione, NIBT 2020 per le norme di installazione, le tariffe USIE per la manodopera, l'OIBT come base legale, e le regole dell'IVA svizzera per la fiscalità.
Per i progetti di domotica si aggiungono gli standard KNX (sistema, IP, ISO/IEC 14543-3) e lo standard svizzero SIA 2044 per l'automazione degli edifici, ancorati alle nostre certificazioni KNX Advanced Partner e KNX Swiss Partner.
Sul piano giuridico facciamo riferimento al Codice delle Obbligazioni svizzero (artt. 197 e 371) per le garanzie. La norma SIA 118 si applica solo se esplicitamente richiamata in offerta o contratto.
Questi non sono standard Elettrosmart. Sono standard nazionali e internazionali consultabili dalle rispettive fonti autoriali.
Una voce CPN è per definizione un prezzo forfettario che comprende:
Questa composizione è caratteristica dello standard CPN svizzero e può differire da sistemi tariffari di altri paesi dove manodopera e materiale sono voci separate.
Un codice CPN è per sua natura un prezzo all-inclusive. Copre già materiale, manodopera, minuteria, trasferta, usura utensili. Non ci sono voci nascoste aggiunte dopo.
Questa è una caratteristica dello standard svizzero, non una scelta Elettrosmart. In altri paesi il sistema tariffario può funzionare diversamente.
ELSM.OFFER.VALIDITY) — le offerte sono valide 3 (tre) mesi dalla data di emissione indicata sul documento, salvo diversa indicazione nell'offerta stessa. Trascorso tale periodo, prezzi e condizioni sono soggetti a revisione (per tener conto della variabilità dei costi dei materiali e delle condizioni dei fornitori)ELSM.WARRANTY.PRODUCTS) — i beni mobili forniti come parte dell'installazione (es. wallbox, interruttori, lampade, elettrodomestici) sono coperti dalla garanzia legale svizzera: 2 anni per i prodotti nuovi dalla data di consegna (Art. 197 e segg. CO). Eventuali garanzie del produttore possono estendere tale periodo e sono trasferite al clienteELSM.WARRANTY.INSTALLATION) — i lavori di installazione che diventano parte integrante dell'edificio (es. cablaggi a muro, tubazioni fisse, quadri di distribuzione, impianti di illuminazione fissi) sono coperti da garanzia di 5 anni (Art. 371 CO). Lavori di riparazione e installazioni minori non integrate nella struttura sono coperti da 2 anniELSM.WARRANTY.SIA118) — quando l'offerta o il contratto richiama esplicitamente la norma SIA 118: 2 anni di periodo di prova con inversione dell'onere della prova in caso di difetti, seguiti da un periodo totale di 5 anni per difetti occulti. L'applicazione di SIA 118 è opt-in, indicata in offerta o nelle condizioni generali quando applicabile; non si applica per defaultL'offerta include ciò che è scritto nella tabella dettaglio, niente di più. L'IVA è mostrata separatamente. Gli imprevisti scoperti in esecuzione sono gestiti con documentazione, preventivo e approvazione prima di procedere — nessun extra fatturato senza consenso del cliente.
Le offerte sono valide 3 mesi dalla data di emissione (salvo diversa indicazione). Le garanzie applicate sono quelle previste dalla legge svizzera: 2 anni sui prodotti (Art. 197 CO), 5 anni sull'opera installata che diventa parte dell'edificio (Art. 371 CO), 2 anni su lavori minori. Quando il contratto richiama esplicitamente la norma SIA 118, valgono le sue regole specifiche (2 anni con inversione dell'onere della prova + 5 anni totali per difetti occulti).
Alcune convenzioni di prassi Elettrosmart che è utile conoscere: per installazioni sopra 3.5 kW la notifica al distributore e il RaSi sono inclusi di default. Il collaudo indipendente, se necessario, è sempre voce separata. Tutte le wallbox includono un cavo dati fino al contatore.
Un caso particolare: una wallbox 22 kW in contesto residenziale svizzero è in realtà limitata a 11 kW per regolamento dei distributori. L'etichetta 22 kW si riferisce alle caratteristiche premium del modello (cavo più lungo, display, ecc.), non alla potenza effettiva di ricarica.
Per i progetti che includono KNX, la prima programmazione (scenari di base, gruppi logici, messa in servizio) è compresa nel prezzo. Modifiche e automazioni aggiuntive richieste dopo la consegna sono trattate separatamente come consulenza.
La programmazione viene fatta con ETS, il software ufficiale KNX, sotto licenza Elettrosmart. Al termine il cliente riceve il database del progetto compilato e la documentazione completa della topologia del bus, in modo che chiunque sia un installatore KNX certificato possa intervenire in futuro senza dipendere da noi.
Le offerte Elettrosmart che adottano Glass-Box Prompting espongono pubblicamente le proprie convenzioni. Quando un'altra offerta per lavori simili adotta anch'essa il protocollo (proprio o equivalente), il confronto semantico tra le due è possibile: ciascuna dichiara cosa include, secondo quali standard, con quale composizione dei prezzi.
Quando l'altra offerta non espone le proprie convenzioni, il confronto resta limitato al testo esplicito di ciascun documento e al prezzo finale. Questo è una proprietà oggettiva del protocollo, non un giudizio di valore sugli altri documenti.
Se confronti due offerte — la nostra e un'altra — e entrambe adottano Glass-Box Prompting, puoi fare un confronto informato: ciascuna dichiara cosa comprende. Puoi (o il tuo assistente AI può) vedere che una include X e l'altra no, e trarre conclusioni oggettive.
Se l'altra offerta non pubblica le sue convenzioni, il confronto è incompleto per natura: sai quello che è scritto esplicitamente in ciascuna, ma non quello che ciascun emittente dà per scontato. Non è una critica all'altro vendor — è semplicemente una limitazione di informazione disponibile.