> 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 Agent Browser da Oxylabs 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](https://developers.oxylabs.io/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 proxy. É 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:** Cadastre-se na [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 da instância e obtenha suas credenciais.

{% hint style="info" %}
Para testar nosso Agent Browser gratuitamente, reivindique um crédito de boas-vindas de US$ 5 [crédito de boas-vindas](https://developers.oxylabs.io/documentation/pt-br/painel/cobranca-baseada-em-creditos.md#free-credits-welcome-credit).
{% endhint %}
{% endstep %}

{% step %}

### Sua primeira solicitação

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

**Exemplo em Python + Playwright:**

1. Instale o Playwright: `pip install playwright`
2. Execute o script a seguir (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:
    # Connect to the remote Oxylabs browser
    browser = p.chromium.connect_over_cdp(browser_url)
    page = browser.new_page()
    
    page.goto('https://oxylabs.io/')
    print(f"Page Title: {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](https://developers.oxylabs.io/products/pt-br/agent-browser.md#features).

### Próximos passos

* **Quer monitorar seu navegador?** Saiba mais sobre a [Ferramenta de Inspeção de Sessão](https://developers.oxylabs.io/products/pt-br/agent-browser/session-inspection-and-recording.md) para acompanhar visualmente as interações do seu script com o navegador em tempo real.
* **Seu script está muito lento?** Tente [Otimizando o tráfego](https://developers.oxylabs.io/products/pt-br/agent-browser.md#recommended-setup) para bloquear ativos desnecessários de serem carregados. Isso aumentará a velocidade de scraping e reduzirá o consumo de largura de banda.
* **Encontrando erros ou timeouts?** Visite o [Guia de Solução de Problemas](https://developers.oxylabs.io/products/pt-br/agent-browser/troubleshooting-guide.md) para resolver problemas comuns de conexão CDP, incompatibilidades de versão de biblioteca e timeouts de execução.
* **Encontrando um "403 Forbidden" em um site importante?** Confira a [Alvos Restritos](https://developers.oxylabs.io/products/pt-br/agent-browser/restricted-targets.md) lista 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.
