> 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/es/agent-browser/troubleshooting-guide.md).

# Guía de resolución de problemas

Aprende a manejar comportamientos inesperados o bajas tasas de éxito al usar Oxylabs Agent Browser.

| Síntoma                                                                      | Causa probable                                                            | Solución                                                                                                                                  |
| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| *La inspección de sesión (VNC) no puede conectarse (el navegador se inicia)* | Se alcanzó el límite máximo de VNC                                        | Use menos sesiones VNC.                                                                                                                   |
| *Error de TLS / certificado*                                                 | Validación de certificado en Node.js                                      | Establecer `NODE_TLS_REJECT_UNAUTHORIZED="0"` antes de requerir Playwright (solo para pruebas).                                           |
| *El perfil se restauró, pero las cookies están vacías*                       | La IP de salida cambió entre sesiones                                     | Fijar `proxy_resi_ses_id` + `proxy_resi_ses_time` con valores idénticos en cada sesión.                                                   |
| *Pared de inicio de sesión / baja tasa de éxito*                             | Reputación de IP, geolocalización incorrecta o incompatibilidad del motor | Establecer `p_cc`, pruebe con otro `p_device`, o cambie el motor y la huella digital. Habilite `page_handler=true` si aparece un desafío. |
| *Destino bloqueado por completo*                                             | Categoría de destino restringida                                          | Complete el KYC a través de su gestor de cuenta dedicado.                                                                                 |

{% hint style="info" %}
Para códigos de error de conexión, sesión y en la página, vea [Códigos de respuesta](/products/es/agent-browser/codigos-de-respuesta.md).\
¿Aún tiene problemas? Póngase en contacto con el soporte de Oxylabs por chat en vivo o por correo electrónico (<support@oxylabs.io>).
{% endhint %}

Si experimenta un comportamiento inesperado o bajas tasas de éxito, considere los siguientes pasos:

{% hint style="info" %}
Para códigos de error de conexión, sesión y en la página, vea Códigos de respuesta.
{% endhint %}

### **Comprenda nuestro proceso de gestión de CAPTCHA**

Familiarícese con nuestros [métodos de gestión de CAPTCHA](/products/es/agent-browser/captcha-handling.md) y su uso. Esto puede aportar información sobre si los desafíos CAPTCHA son la fuente del problema.

### **Use el parámetro de país**

Especificar un parámetro de país en sus solicitudes puede aumentar significativamente las tasas de éxito. Esto garantiza que sus solicitudes se enruten a través de IPs de una ubicación geográfica específica, filtrando IPs de ubicaciones aleatorias o potencialmente menos confiables.

Puede especificar un país para su sesión del navegador añadiendo el `?p_cc` parámetro a su URL de conexión. Puede encontrar más información en la sección [Segmentación por geolocalización](/products/es/agent-browser/geolocation-and-proxy-selection.md).

### **Use el parámetro de tipo de dispositivo**

Experimentar con un parámetro de dispositivo puede resultar en tasas de éxito más altas. Puede personalizar cómo el navegador emula distintos tipos de dispositivo usando el `?p_device` parámetro. Puede encontrar más información en la sección [Tipo de dispositivo](/products/es/agent-browser/device-type.md) .

#### **Pruebe diferentes combinaciones de motor y huella digital**

Las protecciones anti-bot varían según el destino. Si le bloquean, cambie entre huellas digitales de Windows y macOS, o entre el motor de navegador estándar y el propietario. Para destinos protegidos, pruebe `p_src=oxybrowser` con `p_fp_tag=oxyfp_mac_optimized`. Más información en [Motor y huellas digitales](/products/es/agent-browser/motor-y-huellas-digitales.md).

{% hint style="info" %}
Si los problemas persisten después de probar estos pasos, póngase en contacto con su gestor de cuenta dedicado con detalles del problema y los pasos que ya ha realizado.
{% endhint %}

## ¿Necesita habilitar una función? <a href="#need-a-feature-enabled" id="need-a-feature-enabled"></a>

Algunas funciones de Agent Browser están limitadas de forma predeterminada. Para ajustar sus límites, póngase en contacto con el soporte de Oxylabs ([chat en vivo](https://oxylabs.io/) o [correo electrónico](mailto:support@oxylabs.io)) o con su gestor de cuenta dedicado:

* **Más perfiles persistentes** – aumente el límite predeterminado de su cuenta de 5 perfiles guardados.
* **Más sesiones persistentes** – aumente el límite predeterminado de su cuenta de 5 sesiones persistentes concurrentes.
* **Destinos restringidos** – desbloquee más categorías de destino mediante el proceso KYC.
* **Límites de tasa más altos** – aumente por encima de 100 sesiones concurrentes / 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/es/agent-browser/troubleshooting-guide.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.