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

チャットがアプリになる仕組み

「設備別稼働率をカードで見せて」という一言が、どう配信された画面になるのかを説明します。 中身を知れば、なぜ最初の応答に数十秒かかるのか、なぜプレビューが一瞬止まるのか、 故障したときにどこを見るべきかが分かります。

  당신 ──① 말한다──▶ 에이전트 ──② 고친다──▶ 프로젝트(진짜 리액트 코드)
                         │                        │
                         │                   ③ 세션 컨테이너가 띄운다
                         │                        └──▶ 프리뷰 (고치는 즉시 반영)
                         └──④ 스스로 검사한다 (타입 검사 + 화면 보기)

                    ⑤ 배포 ──▶ 버전 보관 ──▶ /container/… (동료가 본다)

プロジェクト1つ = Reactプロジェクト1つ​

スタジオが作るのは画面設定値ではなく、本物のソースコードです。プロジェクトを作成すると、 サーバー内にReactプロジェクトが一式コピーされ、以降の会話はすべてそのファイルを修正する作業になります。

これがノーコードツールとの分かれ目です。

画面設定型ツールスタジオ
生成されるもの設定値Reactソース
ツールができないことを要求すると行き詰まるコードを書けば大抵できる
会話履歴別管理ターンごとに自動コミットされる — 巻き戻せる
「戻して」ができる理由

エージェントは1ターン終わるごとに自動でコミットします。だから気に入らない変更を 直前の状態に戻せますし、いつ何が変わったのかも残ります。 レビューしてから反映したい場合はレビューモードにしてください — ビルダーでアプリを開発する

① 話す — 2つのモードがある​

同じチャット画面でも、やることは異なります。

モードやることアプリを修正するか
クエリプラットフォームデータを読み、表・グラフで答えるいいえ（読み取り専用）
ビルダープロジェクトコードを修正して画面を作るはい

「昨日の3ラインのアラームは何件？」はクエリで、「それを画面にして」からがビルダーです。 → チャットでデータを問い合わせる · ホームからアプリを作成

② 修正する — エージェントが使えるものは決まっている​

エージェントは何でもするわけではありません。決められたツールだけを使います。

ツールやること設けられた制限
ファイル読み書き・一覧プロジェクトソースを修正するそのプロジェクトフォルダの外に出られない
コマンド実行パッケージインストール・ビルドセッションコンテナ内でのみ実行（サーバーシェルではない）
プラットフォーム参照設備・タグ・アラームを読む読み取り専用リストにあるものだけ

🔴 エージェントにはサーバーシェルがありません。 コマンドはそのプロジェクトのコンテナ内で実行され、 ファイルツールはそのプロジェクトフォルダから出られません。アプリが誤って作られても、 他のプロジェクトやサーバーが損傷しない構造です。

③ プレビュー — プロジェクトごとにコンテナが1つ起動する​

プロジェクトを開くと、そのプロジェクト専用コンテナが1つ起動し、その中で開発サーバーが動きます。 プレビュー画面はその開発サーバーをそのまま表示するものなので、エージェントがファイルを修正した瞬間に 反映されます。

デフォルト値なぜそうなのか
コンテナメモリ2 GB1 GBでは3Dウィジェットを含むアプリのビルドがメモリ不足で落ちます（実測値）
アイドル停止30分使用していないプロジェクトがメモリを占有し続けないようにします
アイドル停止は「削除」ではありません

30分間使用しないとコンテナは停止しますが、プロジェクトファイルと会話履歴はそのまま残ります。 再度開くとコンテナが再起動します — だから久しぶりに開くプロジェクトは最初の画面が遅いのです。

同時にいくつ起動できるかが、そのままサーバーメモリの必要量になります → インストール要件

④ 自己検証する — だから最初の応答に時間がかかる​

エージェントはファイルを修正してすぐ終わるわけではありません。

  1. 型チェックを実行します。失敗すると、そのエラーを自分で読み、再度修正します。
  2. 次に実際に画面を表示してみます。 描画された状態を見て、ずれている箇所を検出します。

1つのリクエストでこの往復が最大24回発生します。「なぜこんなに時間がかかるのか」の答えが これであり、同時に一度で動く画面ができる理由でもあります。

大きな画面はまず「構成案」をもらいましょう

画面が大きい場合は、すぐに作成させずに構成案を先に受け取る方が速いです — どのウィジェットを どのデータで配置するかをリストで先に確認し、修正すべき点を直してから作成させると、往復が減ります。

⑤ 配信 — プレビューと配信は別物です​

プレビューは開発サーバーであり、配信はビルドされた成果物です。同僚が見るのは配信版です。

プレビュー配信版
誰が見るか作成者リンクを受け取った人
いつ変わるかエージェントが修正した瞬間配信を押したときのみ
アドレス/preview/…/container/…

配信するとバージョンが蓄積されます（デフォルト10件保存）。新しい配信が誤っていた場合は、以前のバージョンに 戻せます。

🔴 非公開アプリはオーナー・管理者・共有された人だけが開けます。リンクを知っているだけでは開けません — 共有先を指定する必要があります。 → アプリカタログと共有

故障したときにどこを見るか​

症状最初に見る場所
チャットが答えられないAIプロバイダー設定 — 環境設定
プレビューが表示されないセッションコンテナ — プロジェクトを閉じて再度開いてください
データが空プラットフォーム接続・APIキー — 環境設定
配信版だけ古い画面配信を押していません。 プレビューは配信とは異なります

詳細はトラブルシューティングをご覧ください。