> 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/agent-browser/troubleshooting-guide.md). # Guia de solução de problemas Aprenda a lidar com comportamentos inesperados ou baixas taxas de sucesso ao usar o Oxylabs Agent Browser. | Sintoma | Causa provável | Solução | | ------------------------------------------------------------------------ | --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | *Inspeção de sessão (VNC) não consegue se conectar (o navegador inicia)* | Limite máximo de VNC atingido | Use menos sessões VNC. | | *Erro de TLS / certificado* | Validação de certificado no Node.js | Defina `NODE_TLS_REJECT_UNAUTHORIZED="0"` antes de fazer o require do Playwright (somente para testes). | | *Perfil restaurado, mas os cookies estão vazios* | O IP de saída mudou entre as sessões | Fixe `proxy_resi_ses_id` + `proxy_resi_ses_time` com valores idênticos em cada sessão. | | *Barreira de login / baixa taxa de sucesso* | Reputação do IP, geolocalização incorreta ou incompatibilidade do mecanismo | Defina `p_cc`, tente outro `p_device`, ou alterne o mecanismo e o fingerprint. Ative `page_handler=true` se um desafio aparecer. | | *Destino totalmente bloqueado* | Categoria de destino restrita | Conclua o KYC com seu Gerente de Conta Dedicado. | {% hint style="info" %} Para códigos de erro de conexão, sessão e na página, consulte [Códigos de resposta](/products/pt-br/agent-browser/codigos-de-resposta.md).\ Ainda com problemas? Entre em contato com o suporte da Oxylabs via chat ao vivo ou e-mail (). {% endhint %} Se você estiver enfrentando comportamento inesperado ou baixas taxas de sucesso, considere as seguintes etapas: {% hint style="info" %} Para códigos de erro de conexão, sessão e na página, consulte Códigos de resposta. {% endhint %} ### **Entenda nosso processo de tratamento de CAPTCHA** Familiarize-se com nosso [tratamento de CAPTCHA](/products/pt-br/agent-browser/captcha-handling.md) métodos e seu uso. Isso pode fornecer uma ideia de se os desafios de CAPTCHA são a origem do problema. ### **Use o parâmetro de país** Especificar um parâmetro de país nas suas requisições pode aumentar significativamente as taxas de sucesso. Isso garante que suas requisições sejam roteadas por IPs de uma localização geográfica específica, filtrando IPs de locais aleatórios ou potencialmente menos confiáveis. Você pode especificar um país para sua sessão do navegador adicionando o `?p_cc` parâmetro à sua URL de conexão. Mais informações podem ser encontradas na seção [Segmentação por geolocalização](/products/pt-br/agent-browser/geolocation-and-proxy-selection.md). ### **Use o parâmetro de tipo de dispositivo** Testar um parâmetro de dispositivo pode resultar em taxas de sucesso mais altas. Você pode personalizar como o navegador emula diferentes tipos de dispositivo usando o `?p_device` parâmetro. Mais informações podem ser encontradas em [Tipo de dispositivo](/products/pt-br/agent-browser/device-type.md) seção. #### **Tente diferentes combinações de mecanismo e fingerprint** As proteções anti-bot variam conforme o destino. Se você for bloqueado, alterne entre fingerprints de Windows e macOS, ou entre o mecanismo de navegador padrão e o proprietário. Para destinos protegidos, tente `p_src=oxybrowser` com `p_fp_tag=oxyfp_mac_optimized`. Mais informações em [Mecanismo e fingerprints](/products/pt-br/agent-browser/mecanismo-e-fingerprints.md). {% hint style="info" %} Se os problemas persistirem após tentar estas etapas, entre em contato com seu Gerente de Conta Dedicado com detalhes do problema e das etapas que você já seguiu. {% endhint %} ## Precisa de um recurso ativado? Alguns recursos do Agent Browser são limitados por padrão. Para ajustar seus limites, entre em contato com o suporte da Oxylabs ([chat ao vivo](https://oxylabs.io/) ou [e-mail](mailto:support@oxylabs.io)) ou seu Gerente de Conta Dedicado: * **Mais perfis persistentes** – aumente o limite padrão da sua conta de 5 perfis salvos. * **Mais sessões persistentes** – aumente o limite padrão da sua conta de 5 sessões persistentes simultâneas. * **Destinos restritos** – desbloqueie mais categorias de destino por meio do processo de KYC. * **Limites de taxa mais altos** – aumente além de 100 sessões simultâneas / 10 por segundo. --- # 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/products/pt-br/agent-browser/troubleshooting-guide.md?ask=&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.