Buda LogoBuda

WebPreview 預覽

在 Agent 沙箱中執行 Web 應用程式,並把 localhost 連結轉換成可外網存取的 Buda 預覽連結。

WebPreview 用來預覽 Agent 沙箱裡正在執行的 Web 應用程式。你只需要用自然語言告訴 Agent 啟動專案、給出預覽連結,然後使用 Local Browser開啟即可。

什麼時候使用 WebPreview

當 Agent 幫你製作網頁、Demo、小遊戲、Dashboard、前端專案,或修改了一個 Web 應用程式後,你想在瀏覽器裡看到實際效果,就可以使用 WebPreview。

你可以直接這樣說:

請啟動預覽,並給我連結。
請使用 /buda-web-preview 檢查程序,並給我一個可用的預覽連結。
請使用 Local Browser 開啟頁面,檢查是否正常顯示。

基本流程

  1. 在對話框裡讓 Agent 啟動 Web 應用程式或預覽服務。
  2. 等待 Agent 輸出 localhost 連結,例如:
http://localhost:3000
  1. 在 Buda 頁面點擊這個連結,或者打開你的 Local Browser(不要使用 CloudBrowser),把這個連結輸入到網址列。
  2. Buda 會把 localhost 連結轉換成一個外網可存取的預覽連結,通常是 *.budaapps.com 結尾的 URL。
  3. 等待瀏覽器開啟這個 *.budaapps.com URL,即可看到預覽頁面。

其他連接埠也一樣。例如你在 Local Browser 輸入:

http://localhost:4000

Buda 會自動為 4000 連接埠申請外網可存取的預覽連結,並開啟頁面。

預覽沒有正常顯示怎麼辦

如果頁面空白、一直載入,或出現錯誤,請在對話框裡告訴 Agent 檢查服務是否正在執行,並讓它重新給你預覽連結。

可以這樣說:

請檢查預覽服務是否正在執行,並給我預覽連結。
請使用 /buda-web-preview 檢查程序,並給我預覽連結。
預覽沒有正常開啟,請檢查 3000 連接埠的 dev server,並給我一個可用連結。

如果 Local Browser 裡出現 喚醒 按鈕,也可以直接點擊。Buda 會把檢查或重啟請求傳送給 Agent,並在服務恢復後重新整理預覽。

Q&A

開啟 *.budaapps.com 後頁面顯示 Unauthorized,怎麼辦?

回到 Local Browser,重新輸入原本的 localhost 位址,例如:

http://localhost:3000

Buda 會重新申請一個新的簽名預覽連結,並再次開啟頁面。

頁面顯示 Gateway Error,怎麼辦?

通常表示應用程式程序沒有執行,或實際執行連接埠不對。請在對話框裡告訴 Agent:

請使用 /buda-web-preview 技能檢查程序,並給我預覽連結。

你也可以直接點擊 Local Browser 裡的 喚醒 按鈕,觸發同樣的恢復流程。你可以打開 buda-web-preview 技能 頁面查看這個系統內建技能的詳細資訊。

我需要知道啟動命令嗎?

通常不需要。直接用自然語言描述目標即可,例如:

請啟動這個專案,並開啟 WebPreview 給我看。

Agent 會檢查專案結構,啟動合適的服務,並輸出預覽連結。

相關頁面

On this page