Konfiguration (Administrator)

Konfiguration ist nur für Administratorkonten sichtbar. Sie finden sie über das Zahnrad-Symbol (fa-gear, Konfiguration) am unteren Ende der Seitenleiste. Im selben Bereich befinden sich weitere Menüs nur für Administratoren.

Symbol	Menü	Inhalt
`fa-users`	Benutzerverwaltung	Kontenerstellung · Rollen · Passwörter
`fa-chart-column`	Statistik	Nutzung · Aktivität · Bereitstellungen · Audit-Logs
`fa-gear`	Konfiguration	Siehe 7 Reiter unten

Die Konfiguration ist in Reiter oben unterteilt, und alles wird mit einer einzigen [Speichern]-Schaltfläche am unteren Rand des Bildschirms gespeichert (nach dem Speichern wird daneben ✓ 저장됨 angezeigt). Mit Ausnahme der Reiter Allgemein — dort werden Design · Sprache · Logo · Produktname sofort nach dem Klicken angewendet und benötigen kein separates Speichern.

Geheimnisse werden über Umgebungsvariablen verwaltet

Falls API-Schlüssel · Token als Umgebungsvariablen auf dem Server injiziert werden, wird das entsprechende Eingabefeld gesperrt und zeigt das Badge 환경변수로 관리 중 sowie die Meldung "Von Umgebungsvariable injiziert (hier nicht änderbar)" an. Um den Wert zu ändern, müssen Sie .env auf dem Server bearbeiten und ihn neu starten. Das Verfahren wird unter Geheimnissverwaltung beschrieben.

Allgemein (`fa-sliders`)

Worauf wirkt sich das aus — Das Studio-Interface, das Sie sehen, und das Branding, das allen Benutzern angezeigt wird.

Design — Hell / Dunkel. Wird sofort angewendet und wird nur in diesem Browser gespeichert.
Sprache — Deutsch / English. Dies ist ebenfalls eine persönliche Einstellung.
Branding (White-Label) — Änderungen hier gelten für alle Benutzer.
- Logo — PNG/SVG/JPG/WebP · maximal 512 KB. Wird in der Seitenleiste, im Anmeldebildschirm und in der Galerie angezeigt. Mit Standard wiederherstellen können Sie es zurücksetzen.
- Produktanzeigename — Wenn leer gelassen, wird PlantPulse Studio angezeigt.

tipp

Das Logo sieht am besten aus, wenn es ein PNG/SVG mit transparentem Hintergrund ist, das annähernd quadratisch ist (wird in der Seitenleiste auf 24 px verkleinert angezeigt).

AI-Anbieter (`fa-microchip-ai`)

Worauf wirkt sich das aus — Chat-Antworten und die gesamte App-Generierung. Wenn dies leer ist, funktioniert nichts.

Wählen Sie einen von drei Anbietern. Jeder speichert sein Modell · Base URL · Schlüssel separat. Beim Wechsel bleiben die vorherigen Einstellungen erhalten.

Anbieter	Beispiel für Modelleingabe	Base URL
Anthropic (Claude)	`claude-fable-5` · `claude-opus-4-8` · `claude-sonnet-5`	Keine Eingabe erforderlich
OpenAI	`gpt-4o` · `gpt-4.1` · `o3`	Optional (Standard `https://api.openai.com/v1`)
OpenAI-Compatible	Modellname des Servers	Erforderlich — Beispiel `http://vllm-host:8000/v1`

API-Schlüssel — Falls bereits gespeichert, wird das Badge 설정됨 angezeigt. Wenn Sie das Feld leer lassen, wird der vorhandene Schlüssel beibehalten.
Verbindung testen (fa-plug-circle-check) — Verbindet sich mit den Werten, die Sie gerade auf diesem Bildschirm eingegeben haben, tatsächlich mit dem Anbieter. Sie können die Schaltfläche vor dem Speichern drücken und müssen nicht speichern. Bei Erfolg wird ein grünes Häkchen angezeigt, bei Fehler ein rotes Symbol mit der Ursache daneben.

Wenn Sie einen Schlüssel eingegeben haben, aber der Chat nicht funktioniert, fangen Sie hier an

In älteren Versionen gab es diese Schaltfläche nur im Reiter Plattform, daher konnten Sie beim AI-Reiter nur nach dem Speichern im Chat überprüfen, ob alles korrekt war. Jetzt können Sie dies vor dem Speichern überprüfen — Adressfehler · abgelaufene Schlüssel · ausgefallene Gateways werden hier sofort erkannt.

Agent-Verhalten (`fa-robot`)

Worauf wirkt sich das aus — Wie der Agent Apps erstellt und die Konsistenz der Ergebnisse.

Standard-Prompt (Zusätzliche Anweisungen des Betreibers) — Wird nach dem System-Prompt in allen Gesprächen angehängt (maximal 4000 Zeichen). Schreiben Sie interne Regeln · bevorzugte Bibliotheken · Bildschirm-Style-Richtlinien auf. Beispiel: "Fügen Sie das Unternehmenslogo oben auf jedem Bildschirm ein. Einheitliche Chart-Farben im Navy-Ton."
Builder-Engine — 내장 엔진 (기본) / OpenHands 사이드카 (추천). Wirkt sich nur auf App-Build aus, nicht auf Chat (Abfragen). In einer Umgebung mit Sidecar ist OpenHands besser für komplexe Änderungen geeignet.
Vision-Selbstvalidierung — Am Ende eines Turns überprüft die KI einen Screenshot des Bildschirms und behebt Layout-Probleme selbst. Die Qualität verbessert sich, aber der Token-Verbrauch steigt.
Maximale Tool-Schritte pro Turn — 4–48, Standard 24. Die obere Grenze für die Anzahl der Male, die ein Agent Dateien in einer Anfrage liest und bearbeitet. Falls "Maximale Schritte überschritten" häufig bei komplexen Apps auftritt, erhöhen Sie auf 32.
Maximale Response-Token — 1.000–200.000, Standard 128000. Wenn zu niedrig eingestellt, werden lange Code-Blöcke abgeschnitten.

Build-Standards

Legen Sie den Tech Stack · das Layout der generierten Apps fest, damit der Agent nicht willkürlich abweicht. Der Standard-Stack (React + Vite · TypeScript · ECharts-Wrapper · TanStack Query · AppShell/Grid/Section · HashRouter) wird schreibgeschützt angezeigt.

Abhängigkeitssperrung — Blockiert die Installation neuer npm-Pakete. Es wird empfohlen, dies aktiviert zu lassen (in Air-Gap-Netzwerken schlägt die Installation fehl und der Build wird beschädigt).
Layout-Konvention erzwingen — Validiert, dass alle Bildschirme die gemeinsame AppShell verwenden, und wenn nicht, behebt der Agent dies selbst.
Zulässige Ausnahmepakete — Durch Kommas getrennt (Beispiel: leaflet, framer-motion). Selbst mit Sperrung erlaubt diese Liste die Installation.
Standard-App-Layout (neue Apps) — Produktname · Header-Farbe (Beispiel #0e2a4e) · maximale Breite (px, Standard 1280) · Footer-Text. Wird nur auf neue Apps angewendet und rückwirkend nicht auf bestehende Apps.

Runtime (Server global) (`fa-server`)

Worauf wirkt sich das aus — Serverressourcen und App-Zugriffsaktualisierungen. Dies ist für alle Benutzer einheitlich.

Simultane App-Limit — 1–32, Standard 8. Die Anzahl der Entwicklungssitzungen, die gleichzeitig offen sein können. Wählen Sie basierend auf dem Serverspeicher (eine Sitzung = ein Entwicklungsserver).
Automatisches Idle-Shutdown (Minuten) — 0–1440, Standard 30. Wenn während dieser Zeit keine Aktivität erfolgt, wird die Sitzung beendet und Ressourcen freigegeben. 0 = kein automatisches Shutdown. Auch wenn die Sitzung beendet wird, bleiben die Arbeitsschritte erhalten und können beim erneuten Öffnen fortgesetzt werden.

"App-Origin"-Einstellung ist entfernt

In Versionen vor 2026-08-23 gab es in diesem Reiter ein App-Origin-Element zum Angeben der öffentlichen URL für Vorschau- und bereitgestellte Apps. Jetzt werden Apps auf der gleichen Domäne unter /container/ wie Studio bereitgestellt, daher muss nichts angegeben werden.

Falls Sie nach dieser Einstellung basierend auf alten Bildschirmdokumentation suchen, lesen Sie Domäne und Reverse Proxy.

App-Image-Registry

Das Ziel zum Erstellen und Pushen von bereitgestellten Versionen als Container-Images. Der Image Push im Deployment-Drawer des Builders verwendet diese Einstellung. Wenn leer, wird auf dieser Schaltfläche ein "Nicht konfiguriert"-Hinweis angezeigt.

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

Plattform-Integration (`fa-plug`)

Worauf wirkt sich das aus — Echtdaten. Ohne diesen Schlüssel können Standorte · Anlagen · Tags nicht abgerufen werden und die App wird mit Testdaten erstellt.

Plattform-API-Schlüssel — Geben Sie den von der Plattform ausgegebenen X-API-Key ein. Falls vorhanden, zeigt es 설정됨 an. Falls von Umgebungsvariable injiziert, wird es mit 환경변수로 관리 중 gesperrt.
Verbindung testen — Überprüft vor dem Speichern sofort, ob der Schlüssel gültig ist. Bei Erfolg wird 연결됨 angezeigt, bei Fehler wird der Grund direkt angezeigt.

Der Plattform-Verbindungsstatus kann jederzeit in der Statusleiste unten angezeigt werden (verbunden / Antwort abnormal / getrennt).

Git-Integration (`fa-code-branch`)

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

GitLab / GitHub auswählen — Bei Wahl von GitHub wird die Server-URL auf https://github.com fixiert.
Server-URL (Beispiel https://gitlab.example.com) · Namespace (Gruppe/Organisation) (Beispiel myorg/apps)
Benutzername (optional) — Falls leer, wird der Standard oauth2 zur Authentifizierung verwendet.
Zugriffs-Token — glpat-… / ghp_…. Falls gespeichert, wird der vorhandene Wert behalten, wenn leer gelassen.
Bei Bereitstellung automatisch pushen — Bei jeder App-Bereitstellung wird auch zum entfernten Git-Projekt gepusht. Aktivieren Sie dies, wenn Ihre Organisation Versionskontrolle benötigt.

MCP (`fa-diagram-project`)

Worauf wirkt sich das aus — Der Umfang der Tools, die der Agent verwenden kann.

Macht Tools von MCP-Servern dem Agent zugänglich. Zusätzlich zu den integrierten Plattform-Servern können Sie externe MCP-Server (Streamable HTTP) hinzufügen. Neue Tools werden automatisch berücksichtigt (Standard aktiviert).

Serverliste — Jede Zeile zeigt Status-LED · Namen · Adresse · 도구 n개 · Aktivierungskontrollkästchen. Integrierte Server tragen das Badge 내장. Klicken Sie auf eine Zeile, um die Tool-Liste des Servers unten zu öffnen.
MCP-Server hinzufügen — Geben Sie ID · Namen · URL · Authentifizierungs-Header · Token ein.
Tool-spezifische Belichtung — Jedes Tool hat drei separate Schalter: Aktiviert / Chat / Builder. Dies ist nützlich, wenn Sie ein Tool nur im Chat verwenden und beim Build blockieren möchten.
Tools neu entdecken — Falls Sie einem externen Server Tools hinzugefügt haben und diese nicht in der Liste angezeigt werden, drücken Sie dies. Falls "Keine Tools entdeckt" angezeigt wird, überprüfen Sie die Serververbindung.
Konflikt — Falls verschiedene Server Tools mit demselben Namen haben, hat der zuerst registrierte Vorrang und der nächste wird nicht exponiert.

hinweis

Die externe MCP-Server-Adresse muss mit einem Schrägstrich enden (Beispiel https://host/mcp/). Wenn er fehlt, schlägt die Verbindung fehl.

Benutzerverwaltung

Gehen Sie über die Seitenleiste fa-users hinein. Die Tabelle zeigt Benutzername · Name · Rolle · Quelle · Erstellungsdatum.

Es gibt drei Rollen.

Rolle	Kann tun
Administrator	Alles — Konfiguration · Benutzerverwaltung · Statistik eingeschlossen
Builder	Apps erstellen · ändern · bereitstellen, Watcher · Skills verwalten
Viewer	Nur Ansicht — kann keine Apps erstellen ("Viewer-Berechtigung kann keine Apps erstellen")

Konten mit Quelle 환경변수 wurden durch Serverkonfiguration erstellt und können auf dem Bildschirm nicht geändert oder gelöscht werden. Nur 스튜디오 Konten können folgendes:

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

Statistik

Gehen Sie über die Seitenleiste fa-chart-column hinein. Der Zeitraum kann zwischen 7 Tage / 30 Tage / 90 Tage gewählt werden.

Fünf KPI oben: Alle Apps · Bereitgestellte Apps · Chats · Aktive Skills · Anlage-Größe (Standortanzahl · Tag-Anzahl).

Reiter	Inhalte
AI-Nutzung	Agent-Turns · Eingabe/Ausgabe-Tokens, täglich · pro Benutzer · pro Projekt, Builder-Engine-Vergleich
Aktivität	Tägliche Aktivität (nach Aktion), aktivste Benutzer, aktuelle wichtige Ereignisse
Apps	Neue App-Trends, Bereitstellungsstatus, Top bereitgestellte Apps, Template-Nutzungsranking
Chat	Tägliche Fragen, Benutzer mit den meisten Fragen
Bereitstellungen	Bereitstellungsversuche · Erfolge · Fehler, täglich Erfolg/Fehler, aktuelle Bereitstellungshistorie
Audit-Log	Uhrzeit · Benutzer · Aktion · Ziel · Details (mit Suchunterstützung)

Monatliche Inspektionspunkte

Falls in AI-Nutzung die Token plötzlich angestiegen sind, könnten der Watcher-Zyklus zu kurz oder die "Vision-Selbstvalidierung" aktiviert gewesen sein, während viele Builds liefen. Überprüfen Sie die Fehleranzahl im Reiter Bereitstellungen zusammen mit Fehlerbehebung.

Allgemein (fa-sliders)​

AI-Anbieter (fa-microchip-ai)​

Agent-Verhalten (fa-robot)​

Build-Standards​

Runtime (Server global) (fa-server)​

App-Image-Registry​

Plattform-Integration (fa-plug)​

Git-Integration (fa-code-branch)​

MCP (fa-diagram-project)​

Benutzerverwaltung​

Statistik​