> 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/documentation/pt-br/comecar/quick-start-agent-browser.md).

# Início rápido: Agent Browser

Comece a usar o Oxylabs Agent Browser em apenas alguns minutos com um guia simples passo a passo.

{% hint style="success" %}
Já está familiarizado com o básico? Confira [a documentação do Agent Browser](/products/pt-br/agent-browser.md).
{% endhint %}

Oxylabs [Agent Browser](https://oxylabs.io/products/headless-browser) é uma infraestrutura de navegador hospedada na nuvem que lida automaticamente com sistemas de controle de tráfego de bots, CAPTCHAs e rotação de proxies. É totalmente compatível com Playwright, Puppeteer e o Model Context Protocol (MCP) para aplicações de IA.

{% stepper %}
{% step %}

### Configuração e credenciais

1. **Crie uma conta:** Inscreva-se no [Oxylabs Dashboard](https://dashboard.oxylabs.io/).
2. **Adicione uma instância de produto:** Clique em **+ Add product instance** e selecione Agent Browser na categoria Browsers.
3. **Configure:** Escolha o nome da instância, os limites de uso do produto (opcional) e crie a instância.
4. **Obtenha as credenciais:** Clique no produto Agent Browser na tabela de visão geral das instâncias e obtenha suas credenciais.

{% hint style="info" %}
Para testar nosso Agent Browser grátis, resgate um crédito de US$ 5 [de boas-vindas](/documentation/pt-br/dashboard/cobranca-baseada-em-creditos.md#free-credits-welcome-credit).
{% endhint %}
{% endstep %}

{% step %}

### Sua primeira solicitação

O Oxylabs Agent Browser usa o Chrome DevTools Protocol (CDP). Você pode se conectar a ele usando Playwright ou Puppeteer sem precisar gerenciar binários locais do navegador.

**Exemplo com Python + Playwright:**

1. Instale o Playwright: `pip install playwright`
2. Execute o seguinte script (substitua `USERNAME` e `PASSWORD` pelas suas credenciais):

```python
from playwright.sync_api import sync_playwright

username = "USERNAME"
password = "PASSWORD"
endpoint = "hb.oxylabs.io"
browser_url = f"wss://{username}:{password}@{endpoint}"

with sync_playwright() as p:
    # Conecte-se ao navegador remoto da Oxylabs
    browser = p.chromium.connect_over_cdp(browser_url)
    page = browser.new_page()
    
    page.goto('https://oxylabs.io/')
    print(f"Título da página: {page.title()}")
    
    browser.close()
```

{% endstep %}
{% endstepper %}

### Personalizando o navegador

Você também pode passar instruções diretamente pela URL de conexão usando parâmetros de consulta:

<table><thead><tr><th width="138.5">Parâmetro</th><th width="172">Exemplo</th><th>Descrição</th></tr></thead><tbody><tr><td><code>p_cc</code></td><td><code>?p_cc=US</code></td><td>Roteia o tráfego do navegador por um país específico.</td></tr><tr><td><code>p_device</code></td><td><code>?p_device=mobile</code></td><td>Simula um tipo específico de dispositivo.</td></tr><tr><td><code>session_name</code></td><td><code>?session_name=ses-1</code></td><td>Cria uma sessão persistente para manter sua instância remota do navegador em execução na nuvem.</td></tr></tbody></table>

Encontre mais opções de personalização na documentação do [Agent Browser](/products/pt-br/agent-browser.md#features).

### Próximos passos

* **Quer monitorar seu navegador?** Saiba mais sobre a [Session Inspection Tool](/products/pt-br/agent-browser/session-inspection-and-recording.md) para acompanhar visualmente, em tempo real, as interações do seu script com o navegador.
* **Seu script está muito lento?** Experimente [Otimização de Tráfego](/products/pt-br/agent-browser.md#recommended-setup) para bloquear o carregamento de ativos desnecessários. Isso aumentará a velocidade de scraping e reduzirá o consumo de banda.
* **Encontrando erros ou timeouts?** Visite o [Guia de Solução de Problemas](/products/pt-br/agent-browser/troubleshooting-guide.md) para resolver problemas comuns de conexão CDP, incompatibilidades de versão de bibliotecas e timeouts de execução.
* **Está recebendo um "403 Forbidden" em um site importante?** Confira a lista de [Destinos Restritos](/products/pt-br/agent-browser/restricted-targets.md) para ver quais sites ou serviços têm acesso restrito para o Agent Browser.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.oxylabs.io/documentation/pt-br/comecar/quick-start-agent-browser.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.