Programm Dokumentation/Hilfe-Assistent

Das Chatfenster des Hilfe-Assistenten beantwortet Fragen zur Bedienung und zur Rechenlogik. Es kennt den Programmbereich, in dem Sie gerade arbeiten, durchsucht die integrierte Hilfe und formuliert auf Wunsch – mit einem eigenen Zugangsschlüssel – frei formulierte Antworten.

Prinzipbild: Frage mit Kontext → eingebautes Wissen → Antwort; darunter der Weg einer Aktion über den Bestätigungsblock in die Maske.

Eingaben

Die Frage steht im Eingabefeld des Chatfensters; die Kontextzeile darüber zeigt den mitgesendeten Programmbereich. Die Schalter Nur suchen (keine Übertragung, keine Kosten), Aktionen zulassen, Was wird gesendet?, Werkzeuge…, Protokoll anzeigen und Einstellungen… (Zugangsschlüssel, Zeile Heute genutzt mit dem Tageslimit von 50 Anfragen) beschreibt Hilfe-Assistent: Was Sie steuern können.

Beispiel. Zeigt Heute genutzt 50 von 50, beantwortet der Assistent an diesem Tag keine frei formulierte Frage mehr. Nur suchen und „erklären lassen“ an einer Meldung arbeiten weiter, denn sie brauchen weder Netz noch Zugangsschlüssel.

Der Assistent aus einem Dialog heraus

Den Assistenten muss man nicht suchen: Er ist dort erreichbar, wo gearbeitet wird.

Der KI-Knopf neben dem Fragezeichen

Die EPOS-Marke rechts neben dem i oben rechts in jeder Maske öffnet den Assistenten – die drei Felder des Programmlogos, farbig, mit einem Blitz in der Mitte. i und Marke stehen in einem gemeinsamen Rahmen: Das i führt auf die Hilfeseite dieses Dialogs, die Marke ins Gespräch; keiner der beiden Wege ersetzt den anderen.

• Eine Marke je Bildschirm. In einem Dialog oder einer Überlagerung steht sie im Kopf des Dialogs, sonst im Kopfband des Programmfensters, und meint immer die Ansicht, die Sie vor sich haben: Wechseln Sie in der Simulation von der Konfiguration zum Ergebnis, wechselt der Programmbereich mit. Weitere Knöpfe – etwa zum Rechenweg, zu einer Gruppe von Eingaben oder zum Dateiformat – tragen nur das i und führen auf ihre eigene Hilfeseite.
• Blau ausgefüllt ist die Marke, solange das Gespräch zu dieser Ansicht offen ist; so sehen Sie, wofür der Assistent gerade zuständig ist.
• Nicht blockierend. Der Dialog bleibt bedienbar, während die Antwort entsteht.

Der Knopf ist auch ohne Einrichtung da. Ohne Zugangsschlüssel führt er in die Einstellungen. Netz, Schlüssel, Einwilligung und Tageslimit sind keine Bedingung für den Knopf, auch der Lesemodus blendet ihn nicht aus – Fragen ist lesend. Er fehlt nur, wenn der Assistent für diese Installation ganz abgeschaltet ist. Vier Masken führen ihn bewusst nicht: das Chatfenster selbst, seine Werkzeugliste und die beiden Lizenzmasken.

Die Kontextzeile

Über dem Eingabefeld steht, woher Sie kommen: der erkannte Programmbereich und der Name des Dialogs – oder dass kein Bereich erkannt wurde. Der Bereich stammt aus dem Hilfeschlüssel des Dialogs, derselben Angabe, die das Fragezeichen benutzt, und ordnet die Treffer der Hilfesuche.

Aus einer Ansicht mit mehreren Schritten nennt die Zeile auch die Stelle, etwa „Simulation · 3 Ergebnis · Stromspeicher". Für die Ansicht Simulation steht bereits eine Frage bereit, die Sie abschicken oder überschreiben. Auf dem iPad wechselt das Programm dafür die Ansicht und kehrt danach dorthin zurück, woher Sie kamen.

Die Startzeile: was Sie sofort fragen können

Kommen Sie über die Marke aus einem Dialog oder einer Ansicht, steht über dem leeren Eingabefeld eine Startzeile: links Bereich bzw. Dialogname wie in der Kontextzeile, rechts zwei Knöpfe. Ein Klick schickt die Frage sofort als Ihre Nachricht ab.

Knopf	stellt
Aktuellen Dialog erklären	die für diese Ansicht vorbereitete Frage, wenn es eine gibt (wie für Simulation), sonst eine allgemeine Erklärfrage mit dem Namen des Bildschirms
Was kann ich hier tun?	eine eigene, zweite Frage

So zeigt die Marke gleich, was sie kann. Mit der ersten Nachricht im Verlauf verschwindet die Startzeile. Über das Menü „Hilfe › Assistent" öffnet sich der Chat ohne Bildschirmbezug und ohne Startzeile. Ohne Zugangsschlüssel bleiben die beiden Knöpfe sichtbar, aber gesperrt, mit dem Hinweis, zuerst die Einstellungen… zu öffnen.

„Erklären lassen" an einer Meldung

An Warn- und Diagnosemeldungen steht rechts der Link „erklären lassen". Er öffnet den Assistenten mit einer vorbereiteten Frage zu genau dieser Meldung. Abgeschickt wird sie nicht: Sie stellen, ändern oder verwerfen sie – es gibt keinen Assistenten ohne Anwenderfrage.

Zu jeder dieser Meldungen liegt ein Abschnitt im eingebauten Wissen mit Bedeutung, Ursache, Abhilfe und Verweis auf die passende Wikiseite. Gefunden wird er über die Kennung der Meldung, nicht über ihren Wortlaut. Deshalb trägt die Antwort auch ohne Zugangsschlüssel, ohne Netz und bei erschöpftem Tageslimit.

Was dabei übertragen wird

Beim Öffnen aus einem Dialog gehen mit: der Programmbereich, der Name des Dialogs, die Kennung der Meldung und bei „erklären lassen" der Text des Banners.

• Feldwerte nur mit Haken. Der Schalter „Feldwerte mitsenden" im Chatfenster erscheint nur, solange eine dafür freigegebene Maske offen ist. Beim ersten Einschalten werden Sie einmal gefragt; die Zustimmung zum Rechtshinweis ist damit nicht erteilt. Zurücknehmen können Sie sie jederzeit unter Einstellungen….
• „Was wird gesendet?" zeigt vor dem Absenden genau den Text, der übertragen würde, mit Schalter einschließlich der Feldwerte.
• „Nur suchen" überträgt gar nichts.

Der Assistent setzt Felder und rechnet

Der Assistent kann in der offenen Maske mitarbeiten: einen Wert eintragen, mehrere Felder auf einmal füllen, die Maske speichern, eine Maske öffnen und eine Rechnung anstoßen. Jede Änderung legt er zur Bestätigung vor; der Wert landet in der Maske, gespeichert wird erst auf Ihren Wunsch und mit Sicherungskopie.

Beispiel. In einer Maske mit dem Feld Vorlauf (45 °C) bitten Sie: „Setze die Vorlauftemperatur auf 55 °C.“ Der Assistent findet das Feld trotz des ungefähren Namens, der Bestätigungsblock zeigt Vorlauf: 45 → 55. Nach „Ausführen“ steht 55 im Feld, die Maske prüft den Wert wie eine Eingabe von Hand; die Datenbank bleibt unberührt, bis Sie speichern.

Wohin „Maske öffnen“ führt

Beim Öffnen führt der Assistent dorthin, wo die Einstellung liegt:

Masken	gehen auf
Verwaltungs- und Katalogmasken	als eigenes Fenster
Erzeugermasken des Projekts	über die Startseite auf dem Reiter Energieerzeuger
Gebäude- und Bedarfsmasken	auf dem Reiter Wärmebedarf
Kosten, Wirtschaftlichkeit, Übersicht, Bericht	auf ihrem Blatt der Ansicht „Berichte und Kosten"
Betriebskalender, Pufferspeicher-Auslegung, Stromspeicher-Auslegung	als Ansicht des offenen Projekts
Projekt-Export/-Import, Brennstoffe des Projekts, Dublettenwerkzeug	über ihren Menüpunkt

Masken, die erst aus einer anderen heraus aufgehen – die Energieträger-Variante eines Erzeugers und die BHKW-Wirtschaftlichkeit auf dem Blatt „Wirtschaftlichkeit" –, öffnet er nicht selbst; er sagt dann, dass von hier aus kein Weg dorthin führt.

Freigegebene Masken

Bereich	Masken
Erzeuger des Projekts	Heizkessel, BHKW, Pufferspeicher, Stromspeicher, Solarkollektoren, Wärmepumpe (Anlage), Photovoltaik, Kältemaschinen im Projekt
Gerätekataloge (Menü „Administration")	Verwaltungen Heizkessel, BHKW, Solarkollektoren, Pufferspeicher samt den Editoren Heizkessel bearbeiten, Pufferspeicher bearbeiten, BHKW bearbeiten, Solarkollektor bearbeiten; Wärmepumpen verwalten und die Kenndaten einer Wärmepumpe; Modulkatalog (PV‑Module, Stromspeicher, Wechselrichter); Kältemaschinen; Dublettenwerkzeug
Simulationskonfiguration	Pufferspeicher im Projekt, Erdreichquelle, Pufferspeicherquelle, Quellprofil, Wärmesenke, Komponentenkonfiguration

Bereich

Masken

Bedarf

Gebäude im Projekt, Gebäudeverwaltung (Menü „Administration"), Wohnfläche, Gebäudekatalog, Gebäudebedarf, Gebäudetyp, Typprofil, Typstamm, Bedarfsprofile, die drei Bedarfsverwaltungen (Prozesswärme, Stromverbraucher, Brauchwasser), Bedarfsergebnis, Wärmebedarf extern, Solarganglinie, PV-Ganglinien im Projekt, Betriebskalender, Pufferspeicher-Auslegung, die Kataloge Baustoffe und Bauteilaufbauten, Klimadaten, das Zeitraster der Bedarfsgrafik, das Brauchwasser-Zapfprofil mit Auslegung Brauchwasser und Bedarfstag konstruieren

Bereich	Masken
Kosten und Wirtschaftlichkeit	Kostenverwaltung, Energieträgerverwaltung samt Energieträger-Variante und Leistungspreis-Sätzen, Kostenprofil, Kostenfaktoren, Emissionsfaktor-Katalog, Nutzungsdauern, Position einer Kostenvorlage, Worst/Best Case, Wirtschaftlichkeitsparameter, BHKW-Wirtschaftlichkeit, Tarifstruktur, Photovoltaik-Vergütung, gesetzliche Parameter (Katalog und Zeile), Brennstoffe des Projekts
Strom	Peak-Shaving, Speicher-Zeitreihen, Zeitintervall der Stromganglinien-Verwaltung, Anzeige der Ergebnisansichten der Speicherflotte
Ansichten	Stromspeicher-Auslegung mit allen vier Stationen, Simulation samt den Einstellwerten ihres Stromspeicher-Reiters und der Speichergröße des Ergebnisblatts, Kosten, Wirtschaftlichkeit, Übersicht, Bericht, Startseite (Klimaregion, Wahl Profil oder Ganglinie an der Kachel Solarthermie)
Projekt und Programm	Projekt speichern unter, Projektvariante, Projektkopf im Assistenten Neues Projekt, Übernahme ins Projekt, Projekt-Export/-Import (Zielname, Konfliktmodus, Sicherung), Einstellungen
Importe	Optionen von Flotten-CSV, Ganglinien-Importoptionen, Spotpreisimport und Importkonflikte, Kopfeinstellungen des Gebäudeimports

Einzelheiten einzelner Masken

• Neues Projekt – Name, Klimaregion, Kunde, Bearbeiter, Beschreibung; angelegt wird das Projekt erst mit Ihrem „Fertig".
• Einstellungen – die Adressen, „Neue Projekte mit Kühlung anlegen" und die Diagrammfarben; die Ordner, der Name der Datenbank und der Schalter des Assistenten selbst bleiben Ihre Sache.
• Kenndaten einer Wärmepumpe – Vorlaufstufe und Temperatur, COP und Wärmeleistung ihrer Stützstellen; eine neue Stufe oder Zeile legen Sie mit dem Knopf daneben an, übernommen wird mit OK.
• Brauchwasser-Zapfprofil – Stufe, Zonen mit Name, Nutzungsart, Bezugsgröße und Bedarfsniveau, die Stochastik der Stufe Experte, die Eingaben der Auslegung und die Zeilen des Bedarfstags; übernommen wird mit OK, gespeichert mit dem OK der Bedarfsprofile, in denen er auch den Rechenweg Brauchwasser umstellt.

• Importe – das Einlesen und das Übernehmen bleiben Ihr Klick. Im Gebäudeimport setzt er Baualtersklasse, Quelle, Gebäude, Name, Heizsollwert, Nordrichtung und Zonierung; die Zeilen der Bauteile, Räume und Zonenplan-Schritte füllen Sie selbst.

Welche Felder eine Maske dem Assistenten zeigt, nennt er auf die Frage „Welche Felder hat diese Maske?".

Was sich setzen lässt

• Jedes Eingabefeld einer freigegebenen Maske: Zahlen, Texte, Schalter und Auswahlfelder. Ein Auswahlfeld (Energieträger, Betriebsart, Gerät …) setzen Sie mit dem angezeigten Text; der Assistent nennt die möglichen Einträge.
• Feldnamen dürfen ungefähr sein: „Vorlauftemperatur" trifft das Feld Vorlauf. Nur wenn ein Name auf mehrere Felder passt, fragt der Assistent nach, statt zu raten.
• Masken nennen Sie mit ihrem angezeigten Namen oder Schlüssel, etwa „Wärmepumpe im Projekt“; ohne Nennung gilt die gerade geöffnete. Passt ein Name auf mehrere Masken, nennt er die Kandidaten mit Schlüssel.
• Nicht setzbar sind Zeitreihen aus einer Datei (etwa die Tages- und Stundenwerte eines Quellprofils) und Vorgänge, die einen ganzen Satz laden.

Erzeugermasken und Verwaltungen

„Alle Daten anzeigen“. Heizkessel, BHKW, Pufferspeicher, Stromspeicher, Solarkollektoren und Photovoltaik zeigen unter dem Modul den Aufklapper mit allen Werten des gewählten Katalogsatzes. Solange er offen ist, liest und setzt der Assistent diese Werte und speichert sie über dessen Knopf Speichern – wenn Sie ihn darum bitten.

In einer Verwaltung arbeitet er am gewählten Satz im Stammblatt rechts neben der Liste: in den Gerätekatalogen an jedem bearbeitbaren Feld, in den Bedarfsverwaltungen an Typ, Beschreibung und den zwölf Monatswerten, in der Gebäudeverwaltung an jeder Angabe von den Kenndaten über die Hülle bis zu Ferien und Kühlung. Einen anderen Satz wählt er wie ein Klick in die Liste – nicht aber bei ungespeicherten Änderungen; dann bittet er, erst zu speichern oder zu verwerfen. Gespeichert wird mit denselben Prüfregeln wie beim Knopf Speichern.

Auslieferungskatalog (mit Schloss). Ein solcher Satz bleibt unverändert, auch im Aufklapper; der Assistent nennt den Weg über Duplizieren…, der einen eigenen Satz anlegt, bzw. über Schloss aufheben…. Neu…, Duplizieren…, Löschen und Import… bleiben Ihr Klick – sie legen Sätze an oder nehmen sie weg.

In der Simulation und der Wirtschaftlichkeit

Lesen kann er, was auf der Ansicht steht: die Kaskade samt Reihenfolge, die Anlagen des Projekts ohne Platz in der Simulation, die Laufparameter (Netzwärmeverluste, Betriebsart und untere Leistungsgrenze der BHKW, Betriebsbereitschaft und Heizgrenze des Heizkessels), den Schalter Kühlung rechnen und nach einem Lauf Bedarf, Deckung und Rest bei Wärme und Strom, die Speicherentladung, das SoC-Band und die Hinweise des Laufs.

Setzen kann er die Einstellwerte; sie schreiben wie ihre Felder auf der Ansicht sofort:

• die Laufparameter, „Kühlung rechnen", die Werte des Stromspeicher-Reiters und die Speichergröße des Ergebnisblatts;
• für die gewählte Wärmepumpe oder den gewählten Heizkessel die Wärmequelle, die konstante Quelltemperatur, die WP-Priorität und den Betriebsmodus (ein Feld der Simulationsmaske); die Karte wählt er dafür wie ein Klick;
• auf dem Ergebnis die Anzeige: das vordere Blatt und seine Schalter – sortiert (Dauerlinie), die Reihen eines Bildes ein oder aus, im Wärmegang die Bedarfsart. Das ändert nur das Bild; gerechnet und gespeichert wird nichts.

Eine Wärmequelle mit eigenen Angaben (Pufferspeicher, Quellprofil, Erdreich) öffnet ihren Dialog, der erst mit OK übernimmt; ein Profil aus einer Datei wählen Sie selbst. Steht auf der Konfiguration gerade ein solcher Dialog offen, setzt der Assistent nichts daneben, sondern bittet, dort zu wählen oder ihn zu schließen. Alles Übrige ist gerechnet und wird mit Begründung abgelehnt.

Auf dem Blatt Wirtschaftlichkeit setzt er den Zeitraum des Kapitalwertverlaufs und dessen Haken je Variante und Szenario; ein Haken zeichnet nur neu, gerechnet wird erst mit Aktualisieren.

Reihen: Monats-, Stunden- und Wochenwerte

Wo eine Maske eine Folge gleichartiger Zahlen führt – die zwölf Monatswerte eines Bedarfstyps, eines Quellprofils oder einer Leistungspreisreihe, die 24 Stundenwerte einer Tageskurve, die 7 × 24 Werte eines Wochenprofils oder eines Kostenprofils –, trägt der Assistent die ganze Reihe in einem Schritt ein oder nur einen Ausschnitt ab einer Stelle, etwa „setze im Wochenprofil den Dienstag auf 0,5“. Die Bestätigung nennt, wie viele Werte sich ändern, und zeigt die ersten mit altem und neuem Wert. Eine Liste mit der falschen Zahl von Werten oder ein Wert, den das Eingabefeld nicht annimmt, wird mit Begründung abgelehnt.

Beispiel. Ein Bedarfstyp trägt zwölf Monatswerte von je 5. Auf „setze die Monatswerte auf 10, 9, 8, 6, 4, 2, 1, 1, 3, 4, 8 und 9“ nennt die Bestätigung zwölf Änderungen und zeigt die ersten, beginnend mit 5 → 10.

Die Ferienzeiträume des Gebäudekatalogs setzt er Zeitraum für Zeitraum – Beginn und Ende je Tag und Monat –, im Raster der Gebäudehülle auch die Randbedingung der Bodenplatte.

Bestätigen, prüfen, speichern

• Nichts geschieht ohne Ihren Klick. Vor jeder Änderung zeigt der Chat einen Bestätigungsblock mit Feld, aktuellem und neuem Wert, Feld für Feld im Klartext. „Ausführen" trägt ein, „Abbrechen" verwirft, nach einer Minute verfällt die Freigabe. Ein Klick gilt für genau einen Vorgang, kein „ab jetzt immer" (Ändernde Aktionen).

• Unverändertes bleibt. Tragen die genannten Felder den gewünschten Wert schon, meldet der Assistent sie ohne Rückfrage als unverändert; von mehreren Feldern ändert er nur die abweichenden.
• In die Maske, nicht in die Datenbank. Der Wert steht sofort im Eingabefeld, Sie können ihn überschreiben, ergänzen oder verwerfen; gespeichert wird, wenn Sie speichern oder den Assistenten ausdrücklich darum bitten.

• Die Maske prüft wie bei einer Eingabe von Hand. Bei unbrauchbarer Zahl oder verletzter Plausibilitätsprüfung meldet der Assistent, was die Maske sagt – er löst die Prüfung aus, statt sie zu ersetzen.
• Speichern nur mit Sicherungskopie. Vor dem Speichern legt das Programm eine datierte Kopie der Datenbank in den Ordner DB-Backup neben der Datenbank; der Pfad steht in der Bestätigung und im Ergebnis. Gelingt die Kopie nicht, wird nicht gespeichert.

Was er ablehnt

Abgelehnt wird, jeweils mit Begründung im Klartext, wenn

• die Maske nicht offen ist oder das Feld nicht zu den freigegebenen gehört;
• die Angabe errechnet ist – die Diagnose und die Ergebniswerte der Stromspeicher-Ansicht lassen sich lesen, aber nicht setzen;
• die Lizenz nur den Lesemodus erlaubt;
• der bearbeitete Satz zum Auslieferungskatalog gehört und damit schreibgeschützt ist – dann mit dem Weg über Duplizieren…;
• das Feld auf der Maske gerade nicht bedienbar ist, etwa die Stochastik des Zapfprofils außerhalb der Stufe Experte – dann mit dem, was es bedienbar macht;
• in einer Erzeugermaske des Projekts keine Anlage gewählt ist.

Sperrt eine Maske einzelne Felder, nennt der Assistent Feld und Grund schon vor der Rückfrage – etwa den Energieträger einer Anlage und den Leistungspreis der Stromspeicher-Auslegung, die Sie von Hand setzen, oder Felder eines Schritts, der noch nicht erreicht ist.

Bewusst nicht gesteuert werden der Assistent selbst (Chat, Eingabezeile und seine Einstellungen), Lizenz und Schlüssel, die Namens- und Wahlrückfragen, der Bezeichner des Katalogimports, die Übernahme eines Berichtskapitels, der Katalogdialog der Wärmepumpe und die Wertabfrage. Bitten Sie aus einer solchen Maske um einen Wert, nennt er den Grund – statt einer Liste aller Masken.

Rechnen und Abbrechen

Ein Simulationslauf, das Bestimmen des wirtschaftlichen Peak-Ziels und das Bewerten einer Speicherflotte laufen denselben Weg wie der jeweilige Knopf: mit Fortschrittsanzeige und Abbruch, und das Ergebnis steht danach in der Ansicht, nicht nur im Chat. Es läuft immer nur eine Anforderung; eine zweite wird mit Hinweis abgelehnt, statt sich anzustellen.

• Während des Laufs steht im Chatfenster zwischen Gesprächsverlauf und Eingabefeld ein Balken mit einer Zeile, was gerade läuft („Die Kaskade rechnet …"), daneben der Knopf Abbrechen. Eingabefeld, Fragen, Nur suchen und Werkzeuge… sind so lange gesperrt.
• Abbrechen wirkt an der nächsten Phasengrenze des Laufs, nicht auf der Stelle; das sagt die Zeile unter dem Balken, und der Knopf sperrt sich gegen ein zweites Drücken.
• Am Ende verschwindet der Balken, und im Verlauf steht eine Zeile mit Namen und Dauer – „… – fertig nach 42,7 s." bzw. „… – abgebrochen nach 12,3 s.". Ein Abbruch ist kein Fehler: kein halber Zustand, nichts gespeichert, der zuvor gespeicherte Ergebnisstand des Projekts bleibt unberührt.

Protokoll anzeigen führt jeden Versuch, auch abgelehnte und abgebrochene: jede Feldsetzung mit Maske, Feld, altem und neuem Wert, jedes Speichern mit dem Pfad der Sicherungskopie, jeden Rechenlauf mit Dauer (Sicherungspunkt und Protokoll).

Menü und F1

Der Assistent lässt sich auch über das Menü und über F1 aufrufen. Beide Wege übergeben den Bereich, in dem Sie gerade arbeiten – die Marke ist ein zusätzlicher Einstieg, kein Ersatz.

Siehe auch

• Hilfe-Assistent – Aufruf, Datenschutz, Aktionen und Grenzen des Assistenten
• FAQ – häufige Fragen zu Kosten und Datenübertragung