Zum Hauptinhalt springen

Umgebungseinstellungen (Administrator)

Umgebungseinstellungen sind nur für Administratorkonten sichtbar. Sie gelangen darüber über das Zahnrad-Symbol (fa-gear, Umgebungseinstellungen) am unteren Ende der Seitenleiste. An derselben Stelle befinden sich auch die weiteren Administratormenüs.

SymbolMenüInhalt
fa-usersBenutzerverwaltungKonten erstellen · Rollen · Passwörter
fa-chart-columnStatistikNutzung · Aktivität · Bereitstellung · Audit-Log
fa-gearUmgebungseinstellungenDie folgenden 7 Registerkarten

Die Umgebungseinstellungen sind in Registerkarten unterteilt, und über die Schaltfläche [Speichern] am unteren Bildschirmrand wird alles auf einmal gespeichert (nach dem Speichern erscheint daneben ✓ 저장됨). Allerdings werden auf der Registerkarte Allgemein die Werte für Design, Sprache, Logo und Produktname sofort übernommen, sodass kein separates Speichern erforderlich ist.

Umgebungsvariablenwerte sind «Standardwerte», keine Sperre

Wenn API-Schlüssel oder Tokens als Server-Umgebungsvariablen eingegeben werden, erscheint in dem Eingabefeld das Badge 환경변수 기본값, und im leeren Feld wird «Umgebungsvariablenwert wird verwendet — Eingabe überschreibt ihn» ausgegraut angezeigt.

Das Feld ist nicht gesperrt. Wenn Sie hier einen Wert eingeben, überschreiben Sie die Umgebungsvariable und die Änderung wird sofort ohne Neustart angewendet. Wenn Sie das Feld leeren, wird der Wert der Umgebungsvariable verwendet.

Das bedeutet, dass Sie bei einem dringenden Schlüsselwechsel nicht auf dem Server .env ändern und neu starten müssen. Beachten Sie jedoch, dass ein auf dem Bildschirm überschriebener Wert nur für diese Installation gilt. Für eine dauerhafte Änderung sollten Sie die Umgebungsvariable ebenfalls anpassen → Geheimnisverwaltung

Allgemein (fa-sliders)​

Worauf wirkt sich das aus? — Auf den Studio-Bildschirm, den ich sehe, und auf das Branding, das allen Benutzern angezeigt wird.

  • Design — Hell / Dunkel. Wird sofort angewendet und nur in diesem Browser gespeichert.
  • Sprache — Koreanisch / English. Ebenso eine persönliche Einstellung.
  • Branding (White-Label) — Die hier geänderten Werte werden für alle Benutzer angewendet.
    • Logo — png/svg/jpg/webp · max. 512 KB. Wird in der Seitenleiste, auf dem Anmeldebildschirm und in der Galerie verwendet. Mit Standard wiederherstellen wird es zurückgesetzt.
    • Produktanzeigename — Wenn leer, wird PlantPulse Studio angezeigt.
tipp

Ein nahezu quadratisches PNG/SVG mit transparentem Hintergrund sieht am saubersten aus (wird in der Seitenleiste auf 24px verkleinert).

KI-Anbieter (fa-microchip-ai)​

Worauf wirkt sich das aus? — Auf die gesamte Chat-Antwort und die App-Erstellung. Wenn hier nichts eingetragen ist, funktioniert nichts.

Es gibt drei Anbieter zur Auswahl, und jeder speichert Modell, Basis-URL und Schlüssel separat. Beim Wechsel bleiben die vorherigen Einstellungen erhalten.

AnbieterBeispiel für ModelleingabeBasis-URL
Anthropic (Claude)claude-fable-5 · claude-opus-4-8 · claude-sonnet-5Keine Eingabe
OpenAIgpt-4o · gpt-4.1 · o3Optional (Standard https://api.openai.com/v1)
OpenAI-kompatibelVom Server bereitgestellter ModellnameErforderlich — z. B. http://vllm-host:8000/v1
  • API-Schlüssel — Wenn bereits gespeichert, erscheint das Badge 설정됨. Leer lassen, um den vorhandenen Schlüssel beizubehalten.
  • Verbindungstest (fa-plug-circle-check) — Stellt tatsächlich eine Verbindung zum Anbieter her, mit den aktuell auf dem Bildschirm eingegebenen Werten. Kann vor dem Speichern geprüft werden und erfordert kein Speichern. Bei Erfolg erscheint ein grünes Häkchen, bei Fehler eine rote Markierung mit dem Grund daneben.
Wenn der Schlüssel eingegeben wurde, aber der Chat nicht funktioniert, hier zuerst prüfen

Die Prüfung erfolgt vor dem Speichern — Tippfehler in der Adresse · abgelaufene Schlüssel · Gateway-Ausfall werden hier sofort erkannt.

Empfehlung

In einem Air-Gap-Netzwerk können Sie mit OpenAI-kompatibel ein internes vLLM/Ollama-Gateway angeben und so ohne externe Kommunikation betreiben.

Agentenverhalten (fa-robot)​

Worauf wirkt sich das aus? — Auf die Art und Weise, wie der Agent Apps erstellt, und auf die Konsistenz der Ergebnisse.

  • Standard-Prompt (zusätzliche Anweisungen des Betreibers) — Wird hinter dem System-Prompt jeder Konversation angehängt (max. 4000 Zeichen). Geben Sie unternehmensinterne Regeln, bevorzugte Bibliotheken oder Stilrichtlinien für Bildschirme ein. Beispiel: "Platziere das Firmenlogo oben auf jedem Bildschirm. Einheitliche Diagrammfarben in Navy-Tönen."
  • Builder-Engine — 내장 엔진 (기본) / OpenHands 사이드카 (추천). Wirkt sich nur auf die App-Erstellung aus, nicht auf den Chat (Abfragen). In Umgebungen mit installiertem Sidecar ist OpenHands bei komplexen Änderungen robuster.
  • Visuelle Selbstverifikation — Am Ende jedes Turns wird ein Screenshot vom KI überprüft, und Layout-Probleme werden selbstständig korrigiert. Die Qualität steigt, dafür steigt der Token-Verbrauch.
  • Maximale Tool-Schritte pro Turn — 4–48, Standard 24. Obergrenze für die Anzahl an Datei-Lese- und -Korrekturoperationen des Agenten pro Anfrage. Wenn bei komplexen Apps häufig „Maximale Schritte überschritten“ auftritt, erhöhen Sie den Wert auf etwa 32.
  • Maximale Antwort-Tokens — 1.000–200.000, Standard 128000. Bei zu niedrigem Wert wird langer Code mitten abgeschnitten.

Build-Standard​

Legt den technischen Stack und das Layout der erzeugten Apps fest, um zu verhindern, dass der Agent willkürlich davon abweicht. Der Standard-Stack (React + Vite · TypeScript · ECharts-Wrapper · TanStack Query · AppShell/Grid/Section · HashRouter) wird als schreibgeschützt angezeigt.

  • Abhängigkeitssperre — Blockiert die Installation neuer npm-Pakete. Es wird empfohlen, diese zu aktivieren (in einem Air-Gap-Netzwerk schlägt die Installation fehl und der Build bricht ab).
  • Layouteinhaltung erzwingen — Validiert, dass alle Bildschirme das gemeinsame AppShell verwenden. Bei Verstößen korrigiert der Agent dies selbst.
  • Erlaubte Ausnahmepakete — Kommagetrennt (z. B. leaflet, framer-motion). Diese Liste erlaubt die Installation trotz Sperre.
  • Standard-App-Layout (neue Apps) — Produktname · Kopfzeilenfarbe (z. B. #0e2a4e) · max. Breite (px, Standard 1280) · Fußzeilentext. Gilt nur für neu erstellte Apps, nicht rückwirkend für bestehende.

Laufzeit (Serverweit) (fa-server)​

Worauf wirkt sich das aus? — Auf Serverressourcen und die URL, unter der Apps zugänglich sind. Gilt für alle Benutzer.

  • Gleichzeitige App-Limit — 1–32, Standard 8. Anzahl der Entwicklungssitzungen, die gleichzeitig aktiv sein können. Passen Sie es an den Serverspeicher an (eine Sitzung entspricht einem Entwicklungsserver).
  • Automatische Leerlauf-Stopp (Minuten) — 0–1440, Standard 30. Wenn in diesem Zeitraum keine Aktivität stattfindet, wird die Sitzung gestoppt, um Ressourcen freizugeben. 0 = kein automatischer Stopp. Auch nach dem Stopp bleiben die Arbeitsergebnisse erhalten und werden beim erneuten Öffnen fortgesetzt.
Es gibt kein Feld zur Angabe einer App-Origin

Apps werden unter /container/ derselben Domain wie das Studio bereitgestellt, daher gibt es nichts zu spezifizieren. Zur Proxy-Konfiguration siehe Domain und Reverse-Proxy.

App-Image-Registry​

Ziel für den Build von Bereitstellungsversionen als Container-Images und deren Push. Die Image-Push-Funktion im Bereitstellungs-Drawer des Builders verwendet diese Einstellung. Wenn sie leer ist, zeigt die Schaltfläche den Hinweis „Nicht konfiguriert“ an.

  • Registry-URL (z. B. registry.kopens.io) · Namespace (z. B. plantpulse-apps) · Benutzername · Zugriffstoken
  • Wenn das Token bereits gespeichert ist, wird 저장됨 — 변경 시에만 입력 angezeigt.

Plattform-Integration (fa-plug)​

Worauf wirkt sich das aus? — Auf die realen Daten. Ohne diesen Schlüssel können Standorte, Assets und Tags nicht abgefragt werden, sodass Apps mit Beispieldaten erstellt werden.

  • Plattform-API-Schlüssel — Geben Sie den von der Plattform ausgestellten X-API-Key ein. Wenn bereits gespeichert, erscheint das Badge 설정됨. Wenn er aus einer Umgebungsvariable stammt, lautet es 환경변수 기본값. In beiden Fällen können Sie einen Wert eingeben, um ihn zu überschreiben.
  • Verbindungstest — Prüft sofort vor dem Speichern, ob der Schlüssel gültig ist. Bei Erfolg erscheint 연결됨, bei Fehler wird der Grund angezeigt.

Der Plattform-Verbindungsstatus ist jederzeit in der Statusleiste am unteren Bildschirmrand sichtbar (Verbunden / Antwort mit Anomalie / Getrennt).

Git-Integration (fa-code-branch)​

Worauf wirkt sich das aus? — Ob der Quellcode erstellter Apps im Repository des Kunden gespeichert wird.

  • GitLab / GitHub Auswahl — Bei Auswahl von GitHub wird die Server-URL auf https://github.com festgelegt.
  • Server-URL (z. B. https://gitlab.example.com) · Namespace (Gruppe/Organisation) (z. B. myorg/apps)
  • Benutzername (optional) — Leer lassen, um sich mit dem Standard oauth2 zu authentifizieren.
  • Zugriffstoken — glpat-… / ghp_…. Wenn gespeichert, bleibt der vorhandene Wert beim Leerlassen erhalten.
  • Automatischer Push bei Bereitstellung — Bei jeder App-Bereitstellung wird auch in das entfernte Git-Projekt gepusht. Für Organisationen mit Versionsverwaltung sollten Sie dies aktivieren.

MCP (fa-diagram-project)​

Worauf wirkt sich das aus? — Auf den Umfang der Werkzeuge, die der Agent verwenden kann.

Die Werkzeuge von MCP-Servern werden dem Agenten zur Verfügung gestellt. Neben dem integrierten Plattform-Server können Sie externe MCP-Server (Streamable HTTP) hinzufügen. Neue Werkzeuge werden automatisch übernommen (standardmäßig aktiviert).

  • Serverliste — Jede Zeile enthält Status-LED, Name, Adresse, 도구 n개 und Aktivierungs-Checkbox. Der integrierte Server trägt das Badge 내장. Klicken Sie auf eine Zeile, um darunter die Werkzeugliste des Servers zu öffnen.
  • MCP-Server hinzufügen — ID, Name, URL, Authentifizierungsheader und Token eingeben.
  • Werkzeugweise Freigabe — Für jedes Werkzeug können Sie Aktiv / Chat / Builder separat deaktivieren. Nützlich, wenn Sie ein Werkzeug nur im Chat zulassen, im Build aber blockieren möchten.
  • Werkzeuge neu erkennen — Klicken Sie darauf, wenn Sie auf einem externen Server Werkzeuge hinzugefügt haben, die in der Liste nicht erscheinen. Bei „Keine Werkzeuge gefunden“ prüfen Sie die Serververbindung.
  • Konflikte — Wenn auf einem anderen Server ein Werkzeug mit demselben Namen existiert, hat das zuerst registrierte Vorrang; das spätere wird nicht angezeigt.
hinweis

Die Adresse externer MCP-Server muss mit einem Schrägstrich enden (z. B. https://host/mcp/). Fehlt dieser, schlägt die Verbindung fehl.

Benutzerverwaltung​

Zugriff über die Seitenleiste fa-users. Die Tabelle zeigt ID · Name · Rolle · Quelle · Erstellungsdatum.

Es gibt drei Rollen.

RolleBerechtigungen
AdministratorAlles — einschließlich Umgebungseinstellungen, Benutzerverwaltung und Statistik
BuilderApps erstellen, bearbeiten, bereitstellen; Watcher- und Skill-Verwaltung
ViewerNur ansehen — keine App-Erstellung („Viewer-Berechtigung kann keine Apps erstellen“)

Konten mit der Quelle 환경변수 wurden durch die Serverkonfiguration erstellt und können auf dem Bildschirm nicht bearbeitet oder gelöscht werden. Nur Konten mit 스튜디오 können Folgendes:

  • Benutzer hinzufügen — ID, Passwort, Name, Rolle eingeben
  • Rolle ändern · Passwort zurücksetzen (mind. 6 Zeichen) · Löschen
  • Klicken Sie auf das Foto in der Liste, um das Avatar-Bild zu ändern

Statistik​

Zugriff über die Seitenleiste fa-chart-column. Der Zeitraum wird aus 7 / 30 / 90 Tage gewählt.

Fünf KPI oben: GESAMTE APPS · BEREITGESTELLTE APPS · KONVERSATIONEN · AKTIVE SKILLS · PLANT-GRÖSSE (Anzahl Standorte, Anzahl Tags).

RegisterkarteAnzeige
KI-NutzungAgenten-Turns, Eingabe-/Ausgabe-Tokens, täglich · pro Benutzer · pro Projekt, Builder-Engine-Vergleich
AktivitätTägliche Aktivität (nach Aktion), aktivste Benutzer, letzte wichtige Ereignisse
AppsTrend neuer Apps, Bereitstellungsstatus, Top-Apps nach Bereitstellungsversion, Ranking der Vorlagenverwendung
ChatTägliche Fragenanzahl, Benutzer mit den meisten Fragen
BereitstellungBereitstellungsversuche, -erfolge, -fehler, tägliche Erfolge/Fehler, letzte Bereitstellungsverläufe
Audit-LogZeit · Benutzer · Aktion · Ziel · Details (Suche unterstützt)
Monatliche Prüfpunkte

Wenn die Tokens unter KI-Nutzung stark ansteigen, ist die Wahrscheinlichkeit hoch, dass der Watcher-Zyklus zu kurz ist oder ein Massen-Build mit aktivierter „Visueller Selbstverifikation“ lief. Prüfen Sie die Fehleranzahl im Bereitstellung-Tab zusammen mit Problemlösung.