> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/pt-br/ai-studio/browser-agent.md). # Browser Agent ## Visão geral [**Browser Agent**](https://aistudio.oxylabs.io/apps/browser_agent) é uma ferramenta de automação de navegador com IA da [**Oxylabs AI Studio**](https://aistudio.oxylabs.io/). Ele simula a navegação de um usuário real executando ações em várias etapas, como clicar em links, preencher formulários, rolar a página, capturar screenshots e, em seguida, extrair dados estruturados — tudo controlado por prompts em linguagem natural. Diferente de frameworks de automação tradicionais (por exemplo, Puppeteer ou Selenium), o Browser Agent não exige regras estáticas de scraping nem scripts manuais. Você pode descrever tarefas em inglês simples ou fornecer uma sequência de etapas, e a IA as executará exatamente como um humano faria. Você pode visualizar a ferramenta [**aqui**](https://aistudio.oxylabs.io/apps/browser_agent) e integrá-la aos seus fluxos de trabalho por meio dos nossos SDKs Python/JavaScript, servidor MCP ou uma de nossas integrações de terceiros. ## Principais recursos * **Controle total por meio da IA do navegador** – execute cliques, entradas, navegação e rolagem. * **Execução de tarefas em várias etapas** – defina fluxos de navegação em linguagem natural. * **Várias saídas** – obtenha resultados em JSON, Markdown, HTML ou screenshots PNG. * **Suporte a conteúdo dinâmico** – interaja com páginas renderizadas por JavaScript. * **Extração baseada em schema** – solicite JSON estruturado após a conclusão da sequência de navegação. ## Como funciona Para executar tarefas com o agente de IA do navegador, siga estas etapas: 1. **Digite a URL de destino.** 2. **Descreva o processo de navegação como:** * **Prompt em linguagem natural** (por exemplo, “Abra a página de preços, aceite cookies e extraia todos os nomes de produtos com preços.) * **Lista estruturada de etapas** – forneça um array de ações do Browser Agent de IA (`click`, `type`, `navigate`, `wait`, `extract`). 3. **Selecione o formato de saída:** JSON, Markdown, HTML ou screenshot PNG. 4. **(Opcional) Se JSON for selecionado**, defina ou gere automaticamente um schema para estruturar os dados coletados. ### Instalação Para começar, certifique-se de ter acesso a uma chave de API (ou obtenha uma [teste grátis](https://aistudio.oxylabs.io/register) com 1000 créditos) e `Python versão 3.10` ou superior instalado. Você pode instalar o `oxylabs-ai-studio` pacote usando pip: ```sh pip install oxylabs-ai-studio ``` ### Exemplos de código (Python) Os exemplos a seguir mostram como usar o agente de IA do navegador para realizar navegação e extração de dados. ```python from oxylabs_ai_studio.apps.browser_agent import BrowserAgent browser_agent = BrowserAgent(api_key="") schema = browser_agent.generate_schema( prompt="game name, platform, review stars and price" ) print("schema: ", schema) prompt = "Find if there is game 'super mario odyssey' in the store. If there is, find the price. Use search bar to find the game." url = "https://sandbox.oxylabs.io/" result = browser_agent.run( url=url, user_prompt=prompt, output_format="json", schema=schema, ) print(result.data) ``` O exemplo abaixo gera uma screenshot PNG ao usar o Browser Agent. ```python import base64 from oxylabs_ai_studio.apps.browser_agent import BrowserAgent browser_agent = BrowserAgent(api_key="") result = browser_agent.run( url = "https://sandbox.oxylabs.io/", user_prompt= "Go to the website and take a screenshot of the home page", output_format="screenshot", ) with open("screenshot.png", "wb") as f: f.write(base64.b64decode(result.data.content["data"])) ``` Saiba mais sobre o Browser Agent e o SDK Python do Oxylabs AI Studio em nosso [repositório PyPI](https://pypi.org/project/oxylabs-ai-studio/).\ Você também pode conferir nosso [SDK JavaScript da AI Studio](https://github.com/oxylabs/oxylabs-ai-studio-js?tab=readme-ov-file#oxylabs-ai-studio-javascript-sdk) guia para usuários de JS. ### Parâmetros da requisição | Parâmetro | Descrição | Valor padrão | | ---------------------------------------------------------- | ----------------------------------------------------------------- | ------------ | | `url` | URL inicial para navegar | – | | `user_prompt` | Prompt em linguagem natural para extração | – | | `output_format` | Formato de saída (`JSON`, `markdown`, `html`, `screenshot`) | `markdown` | | `schema` | Esquema OpenAPI para extração estruturada (obrigatório para JSON) | – | | `geo_location` | Localização do proxy no formato ISO2 | – | – parâmetros obrigatórios ### Exemplos de saída O Browser Agent pode retornar resultados analisados ou screenshots que são fáceis de integrar às suas aplicações. Veja como é nossa saída JSON: ```json { "type": "json", "content": { "games": [ { "game_name": "Super Mario Odyssey", "platform": "Nintendo Switch", "review_stars": null, "price": 89.99 } ] } } ``` Aqui está uma saída de screenshot da nossa segunda solicitação:
O Browser Agent oferece suporte a vários formatos de saída (`"output": "YOUR_FORMAT"`): * `JSON` – dados estruturados usando análise baseada em schema. * `markdown` – dados fáceis de ler, perfeitos para fluxos de trabalho de IA e automação. * `html` – dados HTML brutos da página da web. * `screenshot` – imagem PNG do conteúdo do navegador. ## Casos de uso práticos Você pode usar o Browser Agent de IA de várias maneiras, incluindo: 1. **Simulação de checkout de e-commerce** – adicionar itens ao carrinho, aplicar cupom, confirmar o fluxo de checkout. 2. **Automação de busca de viagens** – inserir destinos, aplicar filtros e extrair preços de voos ou hotéis. 3. **Extração de vagas de emprego** – pesquisar uma vaga, clicar nos anúncios e extrair detalhes da vaga. 4. **Descoberta de eventos e ingressos** – navegar por sites de eventos, recuperar títulos, datas e preços. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://developers.oxylabs.io/products/pt-br/ai-studio/browser-agent.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.