メインコンテンツまでスキップ

環境設定(管理者)

環境設定は管理者アカウントにのみ表示されます。サイドバーの最下部にある歯車アイコン(fa-gear, 環境設定)からアクセスします。同じ場所に管理者専用メニューが集められています。

アイコンメニュー内容
fa-usersユーザー管理アカウント作成・役割・パスワード
fa-chart-column統計使用量・アクティビティ・デプロイ・監査ログ
fa-gear環境設定下記のタブ7種

環境設定は上部のタブで構成され、画面最下部の [保存] ボタン1つですべてが保存されます(保存されると隣に ✓ 저장됨 が表示されます)。ただし、一般タブのテーマ・言語・ロゴ・製品名はクリックと同時に反映され、個別の保存は不要です。

シークレットは環境変数で管理します

API キー・トークンがサーバー環境変数として注入されている場合、対応する入力欄はロックされ、환경변수로 관리 중 バッジとともに "環境変数から注入されています (ここで変更することはできません)" と表示されます。値を変更するには、サーバーの .env を編集して再起動する必要があります。手順についてはシークレット管理を参照してください。

一般 (fa-sliders)​

影響を与えるもの — 自分が見るStudio画面と、すべてのユーザーに表示されるブランディング。

  • テーマ — ライト / ダーク。即座に適用され、このブラウザのみに保存されます。
  • 言語 — 日本語 / English。同様に個人設定です。
  • ブランディング (ホワイトレーベル) — ここで変更した値はすべてのユーザーに適用されます。
    • ロゴ — png/svg/jpg/webp · 512KB 以下。サイドバー・ログイン画面・ギャラリーに適用されます。デフォルトに戻すで復元できます。
    • 製品表示名 — 空白にすると PlantPulse Studio として表示されます。
ヒント

ロゴは正方形に近い透明背景のPNG/SVGが最適です(サイドバーで24pxに縮小表示)。

AIプロバイダ (fa-microchip-ai)​

影響を与えるもの — チャット回答とアプリ生成全般。ここが空の場合、何も動作しません。

プロバイダは3つから選択でき、各々モデル・Base URL・キーを個別に記憶します。切り替えても以前の設定は残ります。

プロバイダモデル入力例Base URL
Anthropic (Claude)claude-fable-5 · claude-opus-4-8 · claude-sonnet-5入力不要
OpenAIgpt-4o · gpt-4.1 · o3オプション(デフォルト https://api.openai.com/v1)
OpenAI-Compatibleサーバーが提供するモデル名必須 — 例 http://vllm-host:8000/v1
  • API Key — 既に保存されている場合、설정됨 バッジが表示され、空白にするとそのキーは保持されます。
  • 接続テスト (fa-plug-circle-check) — 現在の画面上の入力値でプロバイダに 実際に接続します。保存前に実行しても構いませんし、保存する必要もありません。成功すると緑のチェック、 失敗すると赤い表示とともに理由が隣に表示されます。
キーを入れたのにチャットが動かない場合はここから

以前のバージョンではこのボタンはプラットフォームタブにのみあり、AIタブは値を入力して保存してからチャットで試さないと正否が判断できませんでした。今は保存前に確認できます — アドレスの誤植・期限切れのキー・ゲートウェイダウンをここで直ちに検出できます。

推奨

閉域網ではOpenAI-Compatibleで社内vLLM/Ollamaゲートウェイを指定すれば、外部通信なしで運用できます。

エージェント動作 (fa-robot)​

影響を与えるもの — エージェントがアプリを構築する方法と結果の一貫性。

  • デフォルトプロンプト (運営者追加指令) — すべての会話のシステムプロンプトの後に追加されます(最大4000文字)。社内規則・推奨ライブラリ・画面スタイル指針を記入してください。例: "すべての画面上部に会社ロゴを配置してください。チャート色はネイビー系で統一してください。"
  • ビルダーエンジン — 내장 엔진 (기본) / OpenHands 사이드카 (추천)。アプリビルドのみに影響し、チャット(問い合わせ)には影響しません。サイドカーがインストールされている環境ではOpenHands側が複雑な編集に強みがあります。
  • ビジョン自己検証 — ターン終了時にスクリーンショットをAIが査読してレイアウト問題を自動修正します。品質は向上する一方、トークン消費量が増加します。
  • ターンあたり最大ツールステップ — 4～48、デフォルト24。1回のリクエストでエージェントがファイルを読み込んで修正する回数の上限です。複雑なアプリで「最大ステップ超過」が頻繁に表示される場合は32程度に上げてください。
  • 応答最大トークン — 1,000～200,000、デフォルト128000。低すぎると長いコードが途中で切れます。

ビルド標準​

生成されたアプリの技術スタック・レイアウトを固定し、エージェントが任意に逸脱しないようにします。標準スタック(React + Vite · TypeScript · EChartsラッパー · TanStack Query · AppShell/Grid/Section · HashRouter)は読み取り専用として表示されます。

  • 依存関係ロック — 新しいnpmパッケージのインストールをブロックします。有効にしておくことを推奨します(閉域網ではインストールが失敗してビルドが崩れます)。
  • レイアウト規約の強制 — すべての画面が共通 AppShell を使用するよう検証し、違反があればエージェントが自動修正します。
  • 許可例外パッケージ — カンマ区切り(例: leaflet, framer-motion)。ロック中でもこのリストのパッケージはインストールが許可されます。
  • アプリのデフォルトレイアウト (新規アプリ) — 製品名・ヘッダー色(例 #0e2a4e)・最大幅(px、デフォルト1280)・フッターテキスト。新しく作成するアプリのみに適用され、既存アプリには遡及しません。

ランタイム (サーバーグローバル) (fa-server)​

影響を与えるもの — サーバーリソースとアプリアクセスアドレス。すべてのユーザーに共通です。

  • 同時実行アプリ上限 — 1～32、デフォルト8。同時に起動可能な開発セッション数です。サーバーメモリに合わせて設定してください(セッション1つにつき開発サーバー1つ)。
  • アイドル自動停止 (分) — 0～1440、デフォルト30。その間作業がなければセッションを停止してリソースを回収します。**0 = 自動停止なし。**停止後も作業内容は保存され、再度開くと続行できます。
"アプリオリジン"設定は廃止されました

2026-08-23より前のバージョンではこのタブに、プレビュー・デプロイアプリの公開URLを指定するアプリオリジン項目がありました。現在、アプリはStudioと同じドメインの /container/ 以下で配信されるため、指定する必要がありません。

古い画面ガイドを見てこの項目を探している場合は、ドメインとリバースプロキシを参照してください。

アプリイメージレジストリ​

デプロイ版をコンテナイメージとしてビルドしてpushする先です。ビルダーのデプロイドロワーのイメージpushがこの設定を使用し、空の場合は該当ボタンが「設定されていません」と表示します。

  • レジストリURL(例 registry.kopens.io) · ネームスペース(例 plantpulse-apps) · ユーザー名 · アクセストークン
  • トークンが既に保存されている場合、저장됨 — 변경 시에만 입력 が表示されます。

プラットフォーム連携 (fa-plug)​

影響を与えるもの — 実データ。このキーがないと、サイト・アセット・タグを照会できず、アプリは偽データで生成されます。

  • プラットフォームAPIキー — プラットフォームから発行された X-API-Key を入力します。既にある場合は 설정됨、環境変数として注入されている場合は 환경변수로 관리 중 でロックされます。
  • 接続テスト — 保存前にキーが有効かどうか即座に確認します。成功すると 연결됨、失敗するとその理由が表示されます。

プラットフォーム接続状態は画面下部のステータスバーで常に確認できます(接続中 / 応答異常 / 切断)。

Git連携 (fa-code-branch)​

影響を与えるもの — 作成されたアプリのソースコードを顧客リポジトリに保管するかどうか。

  • GitLab / GitHub 選択 — GitHubを選ぶとサーバーURLは https://github.com に固定されます。
  • サーバーURL(例 https://gitlab.example.com) · ネームスペース (グループ/組織)(例 myorg/apps)
  • ユーザー名 (オプション) — 空白にするとデフォルト値 oauth2 で認証します。
  • アクセストークン — glpat-… / ghp_…。保存されている場合、空白にすると既存値が保持されます。
  • デプロイ時に自動プッシュ — アプリをデプロイするたびにリモートGitプロジェクトにも同時にプッシュします。ソース管理が必要な組織であれば有効にしてください。

MCP (fa-diagram-project)​

影響を与えるもの — エージェントが使用できるツールの範囲。

MCPサーバーのツールをエージェントに公開します。内蔵プラットフォームサーバーに加え、**外部MCPサーバー(Streamable HTTP)**を追加でき、新しく生じたツールは自動的に反映されます(デフォルト有効)。

  • サーバーリスト — 各行にステータスLED・名前・アドレス・도구 n개・有効チェックボックス。内蔵サーバーには 내장 バッジが付きます。行をクリックするとそのサーバーのツールリストが下に展開されます。
  • MCPサーバーを追加 — ID・名前・URL・認証ヘッダ・トークンを入力します。
  • ツール単位の公開 — ツールごとに有効 / チャット / ビルダーの3つを個別に制御できます。チャットのみで使い、ビルドでは制限したい場合に便利です。
  • ツール再発見 — 外部サーバーにツールを追加しましたが、リストに表示されない場合に実行してください。「発見されたツールがありません」と表示されたら、サーバー接続を確認してください。
  • 競合 — 異なるサーバーに同じ名前のツールがある場合、先に登録された側が優先され、後の方は公開されません。
注記

外部MCPサーバーのアドレスには末尾にスラッシュが必須です(例 https://host/mcp/)。省略すると接続に失敗します。

ユーザー管理​

サイドバー fa-users からアクセスします。表にID · 名前 · 役割 · ソース · 作成日が表示されます。

役割は3つあります。

役割できることの例
管理者すべて — 環境設定・ユーザー管理・統計を含む
ビルダーアプリ作成・編集・デプロイ、ウォッチャー・スキル管理
ビューア閲覧のみ — アプリ作成不可("ビューア権限ではアプリを作成できません")

ソースが 환경변수 のアカウントはサーバー設定で作成されたもので、画面から編集・削除はできません。스튜디오 アカウントのみ以下が可能です。

  • ユーザー追加 — ID・パスワード・名前・役割を入力
  • 役割変更 · パスワードリセット(6文字以上) · 削除
  • リスト上の画像をクリックするとアバター画像を変更できます

統計​

サイドバー fa-chart-column からアクセスします。期間は7日 / 30日 / 90日から選択します。

上部KPI 5つ: 全体アプリ数 · デプロイ済みアプリ · 会話数 · アクティブスキル · プラント規模(サイト数・タグ数)。

タブ内容
AI使用量エージェントターン・入力/出力トークン、日別・ユーザー別・プロジェクト別、ビルダーエンジン比較
アクティビティ日別アクティビティ(アクション別)、アクティビティが多いユーザー、最近の主要イベント
アプリ新規アプリ推移、デプロイ状態、デプロイ版トップアプリ、テンプレート使用順位
チャット日別質問数、質問が多いユーザー
デプロイデプロイ試行・成功・失敗、日別成功/失敗、最近のデプロイ履歴
監査ログ時刻・ユーザー・アクション・対象・詳細 (検索対応)
月別点検項目

AI使用量でトークンが急増したら、ウォッチャー周期が短すぎるか、「ビジョン自己検証」が有効なままで大量ビルドが実行された可能性があります。デプロイタブの失敗件数はトラブルシューティングと合わせて確認してください。