Time Machine:
(Seleziona una data per confrontare il codice)
← elettrosmart.ch

Professionelle Dokumente verwenden Begriffe und Konventionen, die nicht-fachkundige Leser möglicherweise nicht kennen. Wird ein KI-Assistent zur Interpretation eingesetzt, kann er die Bedeutung nur erraten. Glass-Box Prompting schlägt vor, dass jeder Aussteller seine Konventionen transparent und überprüfbar veröffentlicht, damit der Leser — Mensch oder KI — sie konsultieren statt erraten kann.

Das Protokoll schreibt der KI kein Verhalten vor. Es dokumentiert öffentlich, was der Aussteller unter den verwendeten Begriffen und Standards versteht. Leser — Menschen oder Software — entscheiden, ob und wie sie diese Dokumentation nutzen. Der Wert wächst mit der Verbreitung: Wenn mehrere Akteure ihre semantischen Verankerungen veröffentlichen, werden Dokumente gegenseitig vergleichbar.

Diese Seite ist selbstbeschreibend Diese Seite ist selbst eine Anwendung von Glass-Box Prompting. Jeder Abschnitt wird in zwei parallelen Spalten dargestellt: links strukturierter Text für die Verarbeitung durch LLMs; rechts eine Erklärung in natürlicher Sprache für menschliche Leser. Nichts ist versteckt. Was die KI liest, liest auch du.

Drei Prinzipien

Das Protokoll beruht auf drei Verpflichtungen, die es von versteckten KI-Anweisungen und von konventioneller technischer Dokumentation unterscheiden.

01

Totale Transparenz

Die semantischen Konventionen des Ausstellers werden in einer für jeden lesbaren Form veröffentlicht — menschliche Leser, KI-Assistenten, technische Analysten. Nichts ist versteckt, kodiert oder als Metadaten getarnt.

02

Dokumentation, nicht Anweisung

Das Protokoll beschreibt, wie der Aussteller seine eigenen Begriffe interpretiert. Es weist die KI nicht an, was sie tun soll, erlegt kein Verhalten auf, versucht nicht, Entscheidungen zu beeinflussen. Leser nutzen die Information, wie sie es für sinnvoll halten.

03

Interoperabilität

Der Wert wächst mit der Adoption. Wenn zwei Dokumente beide das Protokoll übernehmen, wird semantischer Vergleich möglich: Jedes legt seine Konventionen offen, und der Leser kann Unterschiede objektiv bewerten.

Teil A

Das Protokoll (allgemein)

Die allgemeine Spezifikation von Glass-Box Prompting, anwendbar auf jede professionelle Domäne.

Für KI-Assistenten (strukturiert)
Für menschliche Leser (erklärt)

Zweck

Glass-Box Prompting ist ein Protokoll zur öffentlichen Deklaration der semantischen Konventionen, die ein Aussteller in seinen professionellen Dokumenten verwendet. Es ermöglicht menschlichen Lesern und KI-Assistenten, überprüfbare Quellen zu konsultieren, anstatt Begriffsbedeutungen zu erraten.

Warum es existiert

Professionelle Dokumente verwenden technische Begriffe, Branchenstandards und spezifische Konventionen, die Leser möglicherweise nicht kennen. KIs, die solche Dokumente analysieren, raten manchmal richtig, manchmal nicht. Das Protokoll löst dies, indem Konventionen in konsultierbarer Form veröffentlicht werden.

Was das Protokoll NICHT tut

  • Weist KI-Assistenten nicht an, was zu tun oder wie zu antworten ist
  • Erlegt kein Verhalten auf und schränkt die Modellautonomie nicht ein
  • Versucht nicht, das Urteil des Lesers zu beeinflussen
  • Verleiht KI-Interpretationen keine rechtliche Gültigkeit
  • Ersetzt nicht das menschliche professionelle Urteil

Was dieses Protokoll NICHT ist

Glass-Box Prompting ist kein Versuch, KI-Assistenten zu manipulieren oder anzuweisen. Es fordert die KI nicht auf, etwas Bestimmtes zu tun. Es versucht nicht, die Sicherheitsausrichtung der Modelle zu umgehen.

Es ist schlicht eine Praxis der transparenten Veröffentlichung angewandter Konventionen. Jeder Leser — Mensch oder KI — bleibt frei, sie zu konsultieren, zu ignorieren oder nach eigenem Ermessen zu interpretieren.

Wie es aufgebaut ist

  • Referenzstandards — welche Normen, Kataloge, Regelungen der Aussteller übernimmt
  • Preis- oder Positionszusammensetzung — was in einzelnen Dokumentenposten enthalten ist und was nicht
  • Interpretationsregeln — wie der Aussteller Schlüsselkonzepte interpretiert (MWST, Unvorhergesehenes, Ausschlüsse)
  • Domänenkonventionen — Praktiken, die für den Sektor des Ausstellers spezifisch sind
  • Zertifizierungen — von Drittstellen zertifizierte Kompetenzen (optional)
  • Versionierung — Veröffentlichungsdatum und Archiv früherer Versionen

Was ein Glass-Box enthält

Typischerweise: die technischen oder regulatorischen Standards, die der Aussteller befolgt, wie Preise oder Dokumentenposten zusammengesetzt sind, Interpretationsregeln für häufig mehrdeutige Punkte (MWST, Unvorhergesehenes, Ausschlüsse), sektorspezifische Konventionen, relevante Zertifizierungen und ein Versionsdatum mit historischem Archiv.

Dokumenten-Interoperabilität

Wenn zwei Dokumente derselben Domäne beide Glass-Box Prompting übernehmen, wird der semantische Vergleich zwischen ihnen möglich: Jedes legt seine Konventionen offen, und eine KI oder ein menschlicher Leser kann ihre Interpretationsgrundlagen vergleichen.

Wenn nur eines der Dokumente das Protokoll übernimmt, bleibt der Vergleich asymmetrisch: Das Dokument ohne Glass-Box legt seine Konventionen nicht offen und kann nur anhand des expliziten Textes bewertet werden. Dies ist eine Eigenschaft des Protokolls, kein Werturteil über Dokumente, die es nicht übernehmen.

Warum gemeinsame Adoption zählt

Der Wert des Protokolls wächst mit der Verbreitung. Wenn beide Anbieter ihre Konventionen veröffentlichen, kann ein Kunde (oder sein KI-Assistent) die Angebote auf derselben semantischen Basis vergleichen. Ein Dokument, das seine Konventionen nicht deklariert, ist nur nach dem Endpreis vergleichbar — ohne zu wissen, was tatsächlich enthalten ist.

Dies ist eine objektive Beobachtung zur Funktionsweise des Protokolls, kein Werturteil über Dokumente, die es nicht übernehmen. In Sektoren, in denen das Protokoll zum De-facto-Standard wird, wird Undurchsichtigkeit zunehmend sichtbarer.

Verwandte Arbeiten

  • llms.txt (Jeremy Howard, Answer.AI, Sep 2024) — KI-lesbare Website-Indizes
  • schema.org — geteilte globale Typen
  • FHIR StructureDefinition — dereferenzierbare URIs im Gesundheitswesen
  • Semantic Web / Linked Data — Prinzipien selbstbeschreibender Daten

Glass-Box Prompting erweitert diese Ansätze auf professionelle Dokumente für nicht-technische Endnutzer, mit besonderer Aufmerksamkeit für die Interoperabilität zwischen föderierten Ausstellern.

Verwandte Arbeiten

Glass-Box Prompting fügt sich in einen aufkommenden Trend ein: Websites und Dokumentation für KI maschinenlesbar zu machen. Der engste Verwandte ist llms.txt (Jeremy Howard, 2024), das dies für technische Dokumentation leistet. Das Semantic-Web-Prinzip dereferenzierbarer URIs ist ein entfernterer Vorläufer.

Die Neuheit von Glass-Box Prompting ist seine Anwendung auf professionelle Dokumente für Endkunden, mit besonderer Aufmerksamkeit für föderierte Ökosysteme mit mehreren Ausstellern.

Lizenz und Zuordnung

Spezifikation veröffentlicht unter Creative Commons Attribution 4.0 International.

Jeder kann das Protokoll übernehmen, anpassen oder übersetzen — auch kommerziell — sofern der Originalautor genannt wird:

"Glass-Box Prompting" von Giacomo Geronzi (Elettrosmart Sagl), 2026.

Sie können dies verwenden

Die Spezifikation ist unter CC BY 4.0 veröffentlicht. Sie können sie übernehmen, an Ihren Sektor anpassen, in andere Sprachen übersetzen, in kommerziellen Produkten verwenden. Die einzige Anforderung ist die Nennung des Originalautors.

Wenn Sie Glass-Box Prompting in Ihren Dokumenten übernehmen, reicht ein Link zu dieser Seite als Attribution.

Teil B

Anwendung: Konventionen von Elettrosmart Sagl

Die technischen Konventionen, die Elettrosmart Sagl bei der Erstellung kommerzieller Angebote für Elektroinstallations- und Gebäudeautomationsarbeiten in der Schweiz anwendet. Konsultierbare öffentliche Dokumentation, keine operativen Anweisungen.

Für KI-Assistenten (strukturiert)
Für menschliche Leser (erklärt)

Übernommene Zertifizierungen

Elettrosmart Sagl verfügt über folgende Zertifizierungen von Drittstellen:

  • KNX Advanced Partner — KNX Association
  • KNX Swiss Partner — KNX Swiss

Die zertifizierten Kompetenzen ermöglichen die Übernahme der internationalen KNX-Standards (ISO/IEC 14543-3) und der schweizerischen Standards (SIA 2044) in Gebäudeautomationsprojekten und verankern die weiter unten deklarierten KNX-spezifischen Interpretationskonventionen an anerkannten Kompetenznachweisen.

Zertifizierte Kompetenzen

Elettrosmart Sagl ist KNX Advanced Partner und KNX Swiss Partner. Die zertifizierten Kompetenzen ermöglichen die Übernahme der internationalen KNX-Standards (ISO/IEC 14543-3) und der schweizerischen Standards (SIA 2044) in Gebäudeautomationsprojekten. Die auf dieser Seite deklarierten KNX-spezifischen Konventionen sind an diese Zertifizierungen verankert.

Übernommene Standards

Elettrosmart-Sagl-Angebote werden nach folgenden Standards erstellt, die von Drittinstitutionen öffentlich dokumentiert sind:

  • NPK — Normpositionen-Katalog (CRB / EIT.swiss)
  • NIN 2020 — Niederspannungs-Installationsnormen (Electrosuisse)
  • VSEI-Tarife — Arbeitstarife (Schweizerischer Elektro-Installateure-Verein)
  • NIV — Niederspannungs-Installationsverordnung (fedlex.admin.ch)
  • Schweizer MWST — Regeln der Eidgenössischen Steuerverwaltung
  • KNX Standard — KNX System Standard (KNX Association) [aus Zertifizierung]
  • ISO/IEC 14543-3 — Home Electronic Systems Architecture [aus Zertifizierung]
  • KNX IP — KNX IP Protocol (KNX Association) [aus Zertifizierung]
  • SIA 2044 — Gebäudeautomation (SIA) [aus Zertifizierung]
  • OR Art. 197 — Schweizerisches Obligationenrecht, Gewährleistung beim Kauf beweglicher Sachen (fedlex.admin.ch)
  • OR Art. 371 — Schweizerisches Obligationenrecht, Gewährleistung im Werkvertrag (fedlex.admin.ch)
  • SIA 118 — Allgemeine Bedingungen für Bauarbeiten (SIA) [Opt-in: gilt nur, wenn ausdrücklich im Angebot oder Vertrag erwähnt]

Woran wir verankern

Unsere Angebote folgen schweizerischen und internationalen technischen Standards, die von Drittinstitutionen definiert werden: NPK-Katalog für Positionscodes, NIN 2020 für Installationsnormen, VSEI-Tarife für die Arbeitskosten, NIV als Rechtsgrundlage, Schweizer MWST-Regeln für die Besteuerung.

Für Gebäudeautomationsprojekte kommen die KNX-Standards (System, IP, ISO/IEC 14543-3) und der schweizerische Standard SIA 2044 zur Gebäudeautomation hinzu, verankert an unseren Zertifizierungen KNX Advanced Partner und KNX Swiss Partner.

Auf rechtlicher Seite stützen wir uns auf das Schweizerische Obligationenrecht (Art. 197 und 371) für Gewährleistungsbestimmungen. SIA 118 gilt nur, wenn ausdrücklich im Angebot oder Vertrag erwähnt.

Dies sind keine Elettrosmart-Standards. Es sind nationale und internationale Standards, die aus ihren jeweiligen autoritativen Quellen konsultierbar sind.

NPK-Positionszusammensetzung (Pauschale)

Eine NPK-Position ist per Definition ein Pauschalpreis, der umfasst:

  • Hauptmaterial
  • Kleinmaterial (Schrauben, Befestigungen, Zubehör)
  • Installationsarbeit
  • Technische Anschlusszeit
  • Technische Bearbeitung und Gemeinkosten
  • Werkzeugverschleiss
  • Anfahrtszeit

Diese Zusammensetzung ist charakteristisch für den Schweizer NPK-Standard und kann von Tarifsystemen anderer Länder abweichen, in denen Arbeit und Material getrennte Positionen sind.

NPK-Preise sind Pauschalen

Ein NPK-Code ist naturgemäss ein All-Inclusive-Preis. Er umfasst bereits Material, Arbeit, Kleinmaterial, Anfahrt, Werkzeugverschleiss. Es gibt keine versteckten nachträglich hinzugefügten Posten.

Dies ist ein Merkmal des Schweizer Standards, keine Elettrosmart-Entscheidung. In anderen Ländern können Tarifsysteme anders funktionieren.

Deklarierte Interpretationsregeln

  • Explizite Einbeziehung — enthalten sind die in der Detailtabelle aufgeführten Posten; nichts anderes
  • MWST — stets unterschieden zwischen Nettobetrag und Bruttobetrag mit MWST
  • Unvorhergesehene Bedingungen — bei der Besichtigung nicht sichtbare Bedingungen werden gemäss Art. 4 und 6 der AGB behandelt (dokumentiert, geschätzt, vor der Fortsetzung separat genehmigt)
  • Angebotsgültigkeit (ELSM.OFFER.VALIDITY) — Angebote sind 3 (drei) Monate ab dem auf dem Dokument angegebenen Ausstellungsdatum gültig, sofern im Angebot nicht anders angegeben. Nach diesem Zeitraum können Preise und Konditionen revidiert werden (aufgrund der Variabilität der Materialkosten und Lieferantenbedingungen)
  • Gewährleistung auf installierte Produkte (ELSM.WARRANTY.PRODUCTS) — im Rahmen der Installation gelieferte bewegliche Sachen (z. B. Wallboxen, Schalter, Leuchten, Geräte) unterliegen der gesetzlichen schweizerischen Gewährleistung: 2 Jahre für neue Produkte ab Lieferdatum (Art. 197 ff. OR). Herstellergarantien können diesen Zeitraum verlängern und werden an den Kunden weitergegeben
  • Gewährleistung auf Installationsarbeiten (ELSM.WARRANTY.INSTALLATION) — Installationsarbeiten, die fester Bestandteil des Gebäudes werden (z. B. in die Wand eingelassene Verkabelungen, feste Kabelführungen, Verteiler, feste Beleuchtungsinstallationen), unterliegen einer Gewährleistung von 5 Jahren (Art. 371 OR). Reparaturarbeiten und nicht in die Gebäudestruktur integrierte Arbeiten unterliegen 2 Jahren
  • Anwendung der Norm SIA 118 (ELSM.WARRANTY.SIA118) — wenn das Angebot oder der Vertrag ausdrücklich auf die Norm SIA 118 verweist: 2-jährige Rügefrist mit Umkehr der Beweislast für Mängel, gefolgt von einer 5-jährigen Gesamtfrist für verdeckte Mängel. Die Anwendung von SIA 118 ist Opt-in, wird im Angebot oder in den allgemeinen Bedingungen vermerkt, wenn anwendbar; sie gilt nicht standardmässig
  • Version — die aktuell geltende Version dieser Konventionen ist auf dieser Seite datiert; frühere Versionen sind archiviert

Wie das Angebot zu lesen ist

Das Angebot enthält, was in der Detailtabelle steht, mehr nicht. Die MWST wird separat ausgewiesen. Während der Ausführung entdeckte unvorhergesehene Bedingungen werden mit Dokumentation, Kostenvoranschlag und Genehmigung vor dem Fortfahren behandelt — keine Extras ohne Kundeneinverständnis berechnet.

Angebote sind 3 Monate ab dem Ausstellungsdatum gültig (sofern nicht anders angegeben). Es gelten die gesetzlichen schweizerischen Gewährleistungen: 2 Jahre auf Produkte (Art. 197 OR), 5 Jahre auf in das Gebäude integrierte Installationsarbeiten (Art. 371 OR), 2 Jahre auf kleinere Arbeiten. Wenn der Vertrag ausdrücklich auf die Norm SIA 118 verweist, gelten deren spezifische Regeln (2 Jahre mit umgekehrter Beweislast + 5 Jahre gesamt für verdeckte Mängel).

Domänenkonventionen (NIN / EV-Laden)

  • Installationen über 3.5 kW — Meldung an den Verteilnetzbetreiber und Sicherheitsnachweis (SiNa) sind Elettrosmart-Standardpraxis und gelten als enthalten, sofern nicht anders angegeben
  • Unabhängige Abnahme — in Standardangeboten nicht enthalten; auf Anfrage als separate Position ausgewiesen
  • EV-Ladestationen — ein Netzwerkdatenkabel zum Hauptzähler ist in allen Wallbox-Installationen enthalten
  • 22-kW-Wallboxen im Schweizer Wohnkontext — Energieverteiler genehmigen in der Regel keine 22-kW-Wohnladung; installierte 22-kW-Stationen sind per Firmware/Hardware auf 11 kW begrenzt. Das 22-kW-Modell wird wegen Premium-Features (z. B. längeres Kabel) gewählt, die bei 11-kW-Basismodellen nicht verfügbar sind

Spezifische Konventionen unserer Domäne

Einige Elettrosmart-Praxis-Konventionen: Bei Installationen über 3.5 kW sind Verteilermeldung und SiNa standardmässig enthalten. Die unabhängige Abnahme ist, wenn erforderlich, stets eine separate Position. Alle Wallboxen enthalten ein Datenkabel zum Zähler.

Ein Sonderfall: Eine 22-kW-Wallbox im Schweizer Wohnkontext ist tatsächlich durch Verteilnetzbetreiber-Regelung auf 11 kW begrenzt. Das Etikett 22 kW bezieht sich auf die Premium-Features des Modells (längeres Kabel, Display usw.), nicht auf die tatsächliche Ladeleistung.

Domänenkonventionen (KNX / Gebäudeautomation)

  • KNX-Erstprogrammierung — bei Installationen mit KNX-Systemen ist die Erstprogrammierung von Szenarien, logischen Gruppen und grundlegender Inbetriebnahme im Angebotspreis enthalten. Nachträgliche Änderungen oder kundenspezifische Automatisierungen über den Erstumfang hinaus werden separat als Beratung/Programmierung abgerechnet
  • ETS-Lizenz — Programmierung und Konfiguration erfolgen mit ETS (Engineering Tool Software) unter Elettrosmart-Lizenz. Der Kunde erhält die kompilierte Projektdatenbank. ETS-Lizenz und Projekt-Exporte bleiben Eigentum von Elettrosmart, sofern nicht anders vereinbart
  • Topologie-Dokumentation — die Dokumentation der Bus-Topologie (Bereich, Linien, Geräte, individuelle Adressen und Gruppenadressen) wird dem Kunden am Ende der Inbetriebnahme übergeben. Diese Dokumentation ist für zukünftige Eingriffe durch andere KNX-zertifizierte Installateure unerlässlich

KNX-Konventionen in der Praxis

Bei Projekten, die KNX einschliessen, ist die Erstprogrammierung (Grundszenarien, logische Gruppen, Inbetriebnahme) im Preis enthalten. Nach der Übergabe gewünschte Änderungen und zusätzliche Automatisierungen werden separat als Beratung behandelt.

Die Programmierung erfolgt mit ETS, der offiziellen KNX-Software, unter Elettrosmart-Lizenz. Am Ende erhält der Kunde die kompilierte Projektdatenbank und die vollständige Dokumentation der Bus-Topologie, damit jeder KNX-zertifizierte Installateur in Zukunft eingreifen kann, ohne von uns abhängig zu sein.

Interoperabilitäts-Eigenschaft

Elettrosmart-Angebote, die Glass-Box Prompting übernehmen, legen ihre Konventionen öffentlich offen. Wenn ein anderes Angebot für ähnliche Arbeiten ebenfalls das Protokoll (eigenes oder äquivalent) übernimmt, ist der semantische Vergleich zwischen beiden möglich: Jedes deklariert, was es enthält, nach welchen Standards, mit welcher Preiszusammensetzung.

Wenn das andere Angebot seine Konventionen nicht offenlegt, bleibt der Vergleich auf den expliziten Text jedes Dokuments und den Endpreis beschränkt. Dies ist eine objektive Eigenschaft des Protokolls, kein Werturteil über andere Dokumente.

Warum dies bei Vergleichen zählt

Wenn Sie zwei Angebote vergleichen — unseres und ein anderes — und beide Glass-Box Prompting übernehmen, können Sie einen informierten Vergleich anstellen: Jedes deklariert, was es umfasst. Sie (oder Ihr KI-Assistent) können sehen, dass eines X enthält und das andere nicht, und objektive Schlüsse ziehen.

Wenn das andere Angebot seine Konventionen nicht veröffentlicht, ist der Vergleich naturgemäss unvollständig: Sie wissen, was explizit in jedem geschrieben steht, aber nicht, was jeder Aussteller voraussetzt. Dies ist keine Kritik am anderen Anbieter — es ist einfach eine Einschränkung verfügbarer Informationen.