NeuralOS
GuideAdvanced

Dê olhos à sua IA · para que ela não construa às cegas (agent-browser)

Existe um problema silencioso em quase toda IA que constrói código: ela trabalha às cegas. Gera uma tela, te diz "pronto, já funciona"… mas nunca a ABRIU para conferir. Ela não tem olhos. O agent-browser —uma ferramenta open-source da Vercel— dá exatamente isso a ela: a capacidade de abrir seu app num navegador de verdade, olhar, clicar, preencher formulários, conferir que de fato funciona e te avisar o que está quebrado. Você instala no seu agente (Claude Code, Cursor, Codex) e pede que ele VALIDE constantemente o que constrói, em vez de adivinhar. E isso é só o começo: com olhos na web, sua IA também pode navegar em sites, extrair informação, automatizar tarefas repetitivas. Neste guia você vai ver como instalar, o prompt para que ela valide sem você precisar lembrar, e o mundo de possibilidades que isso abre.

Jun 22, 202612 min
Para quem é isto?
Para quem constrói com um agente de código (Claude Code, Cursor, Codex) e quer que ele pare de adivinhar e confira o que faz. É o recurso mais avançado da série (requer um agente de terminal), mas o conceito serve a todos: uma IA que valida o que constrói é uma IA em que você pode confiar.

O problema · sua IA constrói às CEGAS

Isso acontece com todo mundo que constrói com IA, e quase ninguém percebe: a IA gera uma tela, um formulário, um fluxo… e te diz "pronto, já funciona". Mas será que ela abriu para ver? Não. A IA escreve o código e presume que está certo — ela não tem olhos para conferir. É como um cozinheiro que serve o prato sem provar. Às vezes dá certo; outras, o botão não faz nada, o login está quebrado, ou a imagem não carrega — e quem descobre é você, em produção, na frente de um cliente.

A dor de onde nasce · o "pronto" que não estava pronto
O "já funciona" que na verdade estava quebrado é um dos momentos mais frustrantes de construir com IA. Você perde a confiança: cada "pronto" você tem que ir verificar VOCÊ, na mão, abrindo o navegador, clicando, revisando. Isso é lento e cansativo. E se a IA fizesse isso ela mesma, antes de te dizer "pronto"?
Uma história real (a nossa)
Isto não é teoria. Construindo este mesmo produto, no começo pedíamos à IA que fosse revisar o que tinha feito — e ela respondia, com honestidade, "não tenho como abrir o app para ver". Ela construía às cegas. Tudo mudou quando instalamos o agent-browser: desde esse dia a IA passou a abrir o app, navegar por ele e conferir o que construía — e até a validar estes próprios guias ao vivo. O antes e o depois é real, e é justamente o que este guia te ensina a montar.

O que é o agent-browser? · os olhos da sua IA

agent-browser é uma ferramenta open-source da Vercel que dá ao seu agente de IA a capacidade de usar um navegador de verdade: abrir seu app, ver o que há na tela, clicar, escrever em campos, preencher formulários, tirar prints e ler os erros do console. Em bom português: dá olhos e mãos a ela no navegador. Ela para de adivinhar; agora confere.

Imagine assim · o cozinheiro que prova o prato
Uma IA sem agent-browser é um cozinheiro que cozinha e serve sem provar — ele confia que ficou bom. Com o agent-browser, é o cozinheiro que prova cada prato antes de servir: abre, olha, confirma que está bom e só então te diz "pronto". A diferença entre torcer para dar certo e ter certeza.
E não é a mesma coisa que webapp-testing?
Se parecem, mas o agent-browser vai além. A skill webapp-testing (do recurso das 5 skills) testa o SEU app. O agent-browser faz isso e ainda navega por qualquer site da web, extrai informação, automatiza tarefas, e traz um servidor MCP e um vault de credenciais criptografado. É uma ferramenta de navegação completa, não só um testador. Aqui o foco é duplo: validar o que você constrói + abrir o mundo da web para sua IA.

O benefício nº1 · que ela valide constantemente (não às cegas)

Este é o uso que muda o seu jeito de trabalhar: você pede à sua IA que, toda vez que construir algo, abra e valide ela mesma antes de te dizer que está pronto. Construiu um login → que ela se cadastre com uma conta de teste e confirme que entra. Fez um formulário → que preencha e verifique que envia. Mudou uma tela → que abra e confira que está bonita e sem erros no console. Você passa de "acho que funciona" para "testei e funciona".

O hábito · "não me diga pronto sem ter visto"
Transforme isso numa regra permanente para o seu agente: nenhuma tarefa é dada por concluída sem validá-la no navegador. É o mesmo espírito do protocolo C-A-R, mas para a interface: construir → abrir e conferir → só então "pronto". Uma IA que se autoconfere comete muitíssimo menos erros que chegam até você.

O benefício nº2 · abre um mundo de possibilidades

Dar olhos à sua IA não serve só para validar o que é seu. Com um navegador à disposição, ela pode fazer muito mais:

O que sua IA pode fazer com olhos na web
Validar seu app de ponta a ponta: cadastrar, navegar, testar seu fluxo-chave e reportar o que quebra.
Extrair informação de sites (preços, dados, listagens) e te trazer tudo organizado.
Preencher formulários repetitivos e automatizar tarefas chatas do navegador.
Pesquisar: abrir várias páginas, lê-las e te resumir o que importa.
Reutilizar sua sessão: se você já está logado no Chrome, ela pode trabalhar com essa sessão (com a sua permissão).

O que o torna especial (sem tecniquês)

Diferente das ferramentas de automação tradicionais (como o Playwright), o agent-browser foi feito para agentes de IA: em vez de ler a página inteira (o que gasta muitíssimos tokens), ele dá à IA um "mapa" compacto dos elementos com os quais ela pode interagir. Isso significa mais barato e mais rápido para o seu agente. É open-source, da Vercel, com licença permissiva.

vercel-labs/agent-browser
REPO

agent-browser da Vercel — CLI de automação de navegador feita para agentes de IA. Dá ao seu agente (Claude Code, Cursor, Codex) olhos e mãos no navegador: abrir, ver, clicar, preencher, extrair, validar. Usa snapshots da árvore de acessibilidade (eficiente em tokens) e traz servidor MCP. Open-source.

RustApache-2.0View on GitHub

Como instalar (você precisa de um agente de código)

Ele se instala no seu computador com um comando, e na primeira vez baixa o próprio navegador. Depois seu agente de IA usa. (Há várias formas — o npm é a mais comum.)

Instalar agent-browser (npm)bash
npm install -g agent-browser
agent-browser install
Se preferir, deixe seu agente instalar
Como em toda a série: você não precisa brigar com o terminal. Passe ao seu agente o link do repo (github.com/vercel-labs/agent-browser) e diga "instale o agent-browser e configure para que você possa validar o que constrói no navegador". Ele cuida disso, e te avisa se algo você mesmo tiver que fazer. Também existe no Homebrew (brew install agent-browser) e no Cargo, se preferir.

Prompt 1 · Que ela valide TUDO o que constrói (a regra de ouro)

Este é o prompt que muda o seu jeito de trabalhar. Cole no seu agente para que ele pare de construir às cegas:

Cole no seu agente · valide, não adivinhetexto
Você tem o agent-browser instalado. De agora em diante, NÃO me diga que algo "já funciona" sem ter conferido você mesmo no navegador com o agent-browser.

Toda vez que você construir ou mudar algo na interface:
1. Abra o meu app (roda em [sua URL, ex. http://localhost:3000]) com o agent-browser.
2. Navegue até o que você acabou de construir ou mudar.
3. Teste como um usuário de verdade: clique, preencha os campos, complete o fluxo-chave [descreva seu fluxo, ex. "cadastrar → entrar no dashboard"].
4. Confira que está bonito e que NÃO há erros no console do navegador.
5. Se algo estiver quebrado ou feio, conserte e valide de novo, até que de verdade funcione.
6. Só então me diga "pronto", e me conte o que você validou e o que viu.

Regra de ouro: nenhuma tarefa de interface é dada por concluída sem validá-la no navegador. Não construa às cegas.

Prompt 2 · Automatizar / extrair info da web

Para aproveitar o outro superpoder —navegar e automatizar—, este prompt pede à sua IA que use o agent-browser para uma tarefa web concreta:

Cole no seu agente · navegar e extrairtexto
Use o agent-browser para esta tarefa na web, passo a passo:

Quero que você [descreva sua tarefa, ex: "abra esta página [URL], extraia a lista de produtos com seus preços, e me traga tudo numa tabela organizada" / "entre no meu painel do [serviço] e me diga o status de X" / "preencha este formulário com estes dados"].

1. Abra a página e tire um snapshot para ver com quais elementos você pode interagir.
2. Faça a tarefa passo a passo, conferindo em cada passo que o elemento certo está ali.
3. Se eu precisar fazer login, me diga como guardar minhas credenciais de forma segura (o agent-browser tem um vault criptografado; nunca coloque minhas senhas em texto plano).
4. Me entregue o resultado organizado e me diga se algo não deu para fazer.
Segurança · suas credenciais, criptografadas
Se a IA vai entrar em sites com a sua sessão, NUNCA cole suas senhas no chat. O agent-browser traz um vault de credenciais criptografado: você guarda o acesso por nome e a IA usa sem ver a senha. E os arquivos de sessão (que carregam tokens) vão para o .gitignore, nunca para o GitHub. (Conecta com o guia de segurança da série.)
Combine com o C-A-R
O agent-browser é o complemento perfeito da fase de auditar do protocolo C-A-R: quando a IA audita o próprio trabalho, agora ela pode ABRIR o app e conferir de verdade que funciona, não só reler o código. Auditar com olhos é muitíssimo mais poderoso que auditar às cegas.
No NeuralOS, validar faz parte do fluxo
A filosofia de "não construir às cegas" está no coração do NeuralOS: que o que se constrói seja conferido, não presumido. A ideia de uma IA que se autovalida antes de entregar faz parte de como pensamos o produto. Se você quer esse rigor sem montar ferramentas, esse é o caminho.
O protocolo C-A-R · auditar com olhos, não às cegas
O agent-browser turbina a fase de auditar: a IA confere no navegador, não só relê o código.
Blindagem de segurança · proteja suas credenciais
Se sua IA navega com a sua sessão, guarde suas credenciais criptografadas e nunca suba os tokens para o GitHub.
#agent-browser#automação#validação#claude-code
Ready to build?

Start building in
under 3 minutes

Join 4,200+ builders. No credit card. Build your first app with AI in minutes.