WebPreview

O WebPreview permite visualizar um app web que está rodando dentro do sandbox do Agent. Você pode pedir ao Agent, em linguagem natural, para iniciar o app, aguardar um link localhost e abri-lo no seu Local Browser.

Quando usar WebPreview

Use WebPreview quando o Agent criar ou editar um site, demo, jogo, dashboard ou projeto frontend, e você quiser ver o resultado rodando no navegador.

Você pode pedir em linguagem natural:

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.

Fluxo básico

1. Peça ao Agent para rodar o app web ou iniciar o preview.
2. Aguarde até que o Agent mostre um link localhost, por exemplo:

http://localhost:3000

3. Clique nesse link na página do Buda, ou abra o Local Browser (não use o CloudBrowser) e digite o link na barra de endereço.
4. O Buda converte o link localhost em uma URL externa de preview, normalmente terminando em *.budaapps.com.
5. Aguarde essa URL *.budaapps.com abrir no navegador.

O mesmo vale para outras portas. Por exemplo, se você digitar isto no seu Local Browser:

http://localhost:4000

O Buda solicita uma URL de preview para a porta 4000 e abre a página externa acessível.

Se o preview não carregar

Se a página ficar em branco, travada no carregamento ou mostrar erro, peça ao Agent para verificar se o app está rodando e retornar um link novo.

Bons prompts:

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.

Se o seu Local Browser mostrar o botão Despertar, você também pode clicar nele. O Buda enviará uma solicitação de verificação ou reinício ao Agent e atualizará o preview quando o serviço voltar.

Q&A

Abri uma URL *.budaapps.com e apareceu Unauthorized. O que fazer?

Volte ao seu Local Browser e digite novamente a URL localhost original, por exemplo:

http://localhost:3000

O Buda solicitará uma nova URL de preview assinada e abrirá a página novamente.

O preview mostra Gateway Error. O que fazer?

O processo do app pode não estar rodando, ou pode estar em outra porta. Peça ao Agent:

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

Você também pode clicar em Despertar no seu Local Browser para acionar o mesmo fluxo de recuperação. Você pode abrir a página da buda-web-preview skill para ver os detalhes desta skill gerenciada pelo sistema.

Preciso saber o comando para iniciar o app?

Normalmente, não. Diga ao Agent o que você quer em linguagem natural, por exemplo:

Please start this project and show me the web preview.

O Agent deve inspecionar o projeto, iniciar o servidor correto e mostrar o link de preview.