WebPreview

Agent sandbox で動く Web アプリを、localhost リンクから外部アクセス可能な Buda プレビュー URL として開きます。

WebPreview は、Agent sandbox 内で実行されている Web アプリを確認するための機能です。自然言語で Agent にアプリの起動とプレビューリンクの提示を依頼し、そのリンクを Local Browser で開きます。

WebPreview を使う場面

Agent が Web ページ、デモ、ゲーム、ダッシュボード、フロントエンドプロジェクトを作成または編集し、実際の画面をブラウザーで確認したいときに使います。

次のように自然言語で依頼できます。

Start the dev server and give me the preview link.

Please use /buda-web-preview to check the process and give me a working preview link.

Open the page in your Local Browser and check whether it works.

http://localhost:3000

Buda ページ上でそのリンクをクリックするか、Local Browser (CloudBrowser は使用しないでください) を開いてアドレスバーに入力します。
Buda は localhost リンクを外部アクセス可能なプレビュー URL に変換します。通常は *.budaapps.com で終わる URL です。
ブラウザーでその *.budaapps.com URL が開くまで待つと、プレビューを確認できます。

他のポートでも同じです。たとえば Local Browser に次の URL を入力します。

http://localhost:4000

Buda は port 4000 用の外部アクセス可能なプレビュー URL を取得して開きます。

ページが空白のまま、読み込み中のまま、またはエラーが表示される場合は、サービスが実行中かどうかを Agent に確認させ、最新のリンクを返すよう依頼してください。

使える依頼文:

Please check whether the preview service is running and give me the preview link.

Please use /buda-web-preview to check the process and give me a preview link.

The preview did not load. Please check the dev server on port 3000 and give me a working link.

Local Browser に起動ボタンが表示されている場合は、それをクリックできます。Buda は確認または再起動の依頼を Agent に送り、サービスが復旧したあとにプレビューを更新します。

Local Browser に戻り、元の localhost URL をもう一度入力してください。例:

http://localhost:3000

Buda が新しい署名付きプレビュー URL を取得して、再度ページを開きます。

アプリのプロセスが動いていないか、別のポートで動いている可能性があります。Agent に次のように依頼してください。

Please use /buda-web-preview to check the process and give me a preview link.

Local Browser の起動ボタンをクリックして、同じ復旧フローを実行することもできます。buda-web-preview スキルページを開いて、このシステム管理スキルの詳細を確認できます。

通常は不要です。次のように自然言語で目的を伝えます。

Please start this project and show me the web preview.

Agent がプロジェクト構成を確認し、適切なサービスを起動して、プレビューリンクを出力します。