WebPreview 預覽
在 Agent 沙箱中執行 Web 應用程式,並把 localhost 連結轉換成可外網存取的 Buda 預覽連結。
WebPreview 用來預覽 Agent 沙箱裡正在執行的 Web 應用程式。你只需要用自然語言告訴 Agent 啟動專案、給出預覽連結,然後使用 Local Browser開啟即可。
什麼時候使用 WebPreview
當 Agent 幫你製作網頁、Demo、小遊戲、Dashboard、前端專案,或修改了一個 Web 應用程式後,你想在瀏覽器裡看到實際效果,就可以使用 WebPreview。
你可以直接這樣說:
請啟動預覽,並給我連結。請使用 /buda-web-preview 檢查程序,並給我一個可用的預覽連結。請使用 Local Browser 開啟頁面,檢查是否正常顯示。基本流程
- 在對話框裡讓 Agent 啟動 Web 應用程式或預覽服務。
- 等待 Agent 輸出 localhost 連結,例如:
http://localhost:3000- 在 Buda 頁面點擊這個連結,或者打開你的 Local Browser(不要使用 CloudBrowser),把這個連結輸入到網址列。
- Buda 會把 localhost 連結轉換成一個外網可存取的預覽連結,通常是
*.budaapps.com結尾的 URL。 - 等待瀏覽器開啟這個
*.budaapps.comURL,即可看到預覽頁面。
其他連接埠也一樣。例如你在 Local Browser 輸入:
http://localhost:4000Buda 會自動為 4000 連接埠申請外網可存取的預覽連結,並開啟頁面。
預覽沒有正常顯示怎麼辦
如果頁面空白、一直載入,或出現錯誤,請在對話框裡告訴 Agent 檢查服務是否正在執行,並讓它重新給你預覽連結。
可以這樣說:
請檢查預覽服務是否正在執行,並給我預覽連結。請使用 /buda-web-preview 檢查程序,並給我預覽連結。預覽沒有正常開啟,請檢查 3000 連接埠的 dev server,並給我一個可用連結。如果 Local Browser 裡出現 喚醒 按鈕,也可以直接點擊。Buda 會把檢查或重啟請求傳送給 Agent,並在服務恢復後重新整理預覽。
Q&A
開啟 *.budaapps.com 後頁面顯示 Unauthorized,怎麼辦?
回到 Local Browser,重新輸入原本的 localhost 位址,例如:
http://localhost:3000Buda 會重新申請一個新的簽名預覽連結,並再次開啟頁面。
頁面顯示 Gateway Error,怎麼辦?
通常表示應用程式程序沒有執行,或實際執行連接埠不對。請在對話框裡告訴 Agent:
請使用 /buda-web-preview 技能檢查程序,並給我預覽連結。你也可以直接點擊 Local Browser 裡的 喚醒 按鈕,觸發同樣的恢復流程。你可以打開 buda-web-preview 技能 頁面查看這個系統內建技能的詳細資訊。
我需要知道啟動命令嗎?
通常不需要。直接用自然語言描述目標即可,例如:
請啟動這個專案,並開啟 WebPreview 給我看。Agent 會檢查專案結構,啟動合適的服務,並輸出預覽連結。