AI-translated from English; not yet reviewed by a fluent editor. # Configura una tarea de navegador con la API de Agents y el uso del ordenador de OpenAI > Guía basada en la documentación para crear una sesión de navegador con la API de Agents de OpenAI, gestionar solicitudes de origen web, comprobar el resultado y eliminar la sesión. By BIG CHANGE Editorial Published: 2026-09-30T01:36:49.389Z Updated: 2026-09-30T01:36:49.389Z Canonical: https://bigchange.ai/blog/openai-agents-api-computer-use-browser-guide ![Conceptual illustration of a developer viewing a generic public webpage on one desktop display and three browser activity images on another.](https://bigchange.ai/api/media/file/agents-computer-use-browser-review-hero-v1.png) AI-generated by OpenAI; BIG CHANGE conceptual editorial illustration. El 29 de septiembre, en el [resumen de DevDay](https://openai.com/index/devday-2026-recap/) de OpenAI se anunció el uso del ordenador en la API de Agents. Nuestra [guía de lanzamiento de DevDay](https://bigchange.ai/blog/openai-devday-2026-launches-availability-guide) cubre el lanzamiento más amplio. Para un desarrollador, la tarea inmediata es más acotada que la de un agente de navegador general: abrir una página pública, obtener una respuesta concreta y dejar constancia de lo que consultó el navegador. La [guía de uso del ordenador](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use) de OpenAI, consultada el 30 de septiembre, documenta ese flujo mediante una sesión de navegador alojada. BIG CHANGE ha revisado la documentación, pero no ha ejecutado la API. La aplicación crea la sesión, envía la entrada, sigue los eventos, presenta al usuario las solicitudes de acceso a sitios web, comprueba la respuesta y limpia el entorno. El agente puede manejar el navegador dentro del entorno alojado. Que un turno termine no demuestra que la información solicitada sea correcta. ## El gran cambio La nueva función de uso del ordenador de la API de Agents de OpenAI ofrece a los desarrolladores una sesión de navegador alojada con un flujo de eventos, decisiones del usuario sobre los orígenes web, registros de actividad del navegador y limpieza mediante la API. Para una tarea acotada en una página pública, la integración práctica consiste en gestionar explícitamente esas etapas y verificar el título y la URL devueltos. El acceso a un origen, la finalización de un turno y la exactitud de la respuesta son observaciones distintas. ## Empieza con una clave de API y una sesión de navegador La [guía de inicio rápido de la API de Agents](https://developers.openai.com/api/docs/guides/agents-api/quickstart#prerequisites) de OpenAI requiere una clave de API de aplicación en un proyecto de OpenAI Platform. Especifica `api.agents.read` y `api.agents.write` para las operaciones de sesión, y `api.responses.write` para la inferencia del modelo. Exporta la clave como `OPENAI_API_KEY` en el entorno de la aplicación y mantenla fuera del entorno aislado del agente. Utiliza una versión actual del SDK de OpenAI con la API beta de Agents; el tutorial de JavaScript de la guía de uso del ordenador utiliza `openai` y `prompt-sync`. La alternativa con cURL requiere Bash, `jq` y la cabecera explícita `OpenAI-Beta: agents=v1`. La configuración documentada de la sesión coloca `{ "type": "computer_use" }` en `agent.tools`, establece `environment.type` como `openai_hosted` y habilita `environment.desktop.enabled`. El ejemplo para páginas públicas también habilita el acceso a la red y establece `include_screenshots: true` en la herramienta. Al crear la sesión se obtiene un ID para las solicitudes posteriores de eventos y elementos; eso no inicia la tarea del navegador. Guarda el ID antes de continuar. El ejemplo de la guía pide al agente que encuentre la guía de inicio rápido de la API de Agents y devuelva el título y la URL de la página, sin iniciar sesión ni modificar datos del sitio. ## Sigue la tarea y decide a qué sitios puede acceder Abre el flujo de eventos de la sesión antes de enviar la entrada de la tarea para que la aplicación pueda recibir los primeros eventos. La entrada documentada es un `agent.session.input.message`. Cuando el flujo indique `agent.session.requires_action`, recupera el `required_actions` actual de la sesión e identifica los registros `computer_use_approval_request` pendientes. Si se recibe una solicitud de `browser_origin_access`, muestra al usuario el origen solicitado y el motivo indicado, si lo hay. Envía su decisión de `approve`, `deny` o `cancel` como un `agent.session.input.computer_use_approval_request_result` con el `request_id` correspondiente. Esa decisión se refiere al acceso a un origen de sitio web, incluso si es público. Establecer `network.access` en `enabled` no concede la aprobación. Tampoco significa que se haya confirmado cada acción posterior del navegador. OpenAI indica que las aplicaciones que requieren confirmación garantizada antes de compras o cambios destructivos deben limitar el navegador alojado a recursos que no puedan realizar esas acciones, o utilizar un entorno de navegador bajo su control. El texto de los sitios web es una entrada no confiable y no puede autorizar el acceso ni sustituir las instrucciones del usuario. El recorrido por una página pública cancela una solicitud distinta de `browser_authentication`. Las tareas que necesitan una cuenta tienen su propio [flujo de inicio de sesión](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use#handle-sign-in); esta configuración de solo lectura no lo cubre. OpenAI también señala que cancelar una solicitud de aprobación no cancela la tarea. Una respuesta de aprobación aceptada significa que se recibió la decisión, no que la navegación haya terminado. ## Comprueba el resultado, revisa la actividad y elimina la sesión El flujo de eventos puede proporcionar el texto de la respuesta en `agent.session.turn.output_text.done`. Espera a `agent.session.turn.completed` para el turno principal y gestiona por separado los eventos de error y cancelación. Para la tarea documentada, comprueba si la respuesta contiene realmente el título y la URL de la guía de inicio rápido. Que se cierre el flujo no demuestra por sí solo que el turno haya terminado; OpenAI indica que, si se pierde la conexión o el resultado es incierto, se debe recuperar la misma sesión. Los elementos de la sesión ofrecen otra perspectiva del trabajo del navegador. Los elementos `computer_use_call` incluyen un título de actividad, el ID del turno y el estado. Si se habilitan las capturas de pantalla, un elemento puede incluir una URL de imagen `computer_screenshot`; algunas operaciones siguen sin devolver ninguna imagen. Estos elementos muestran operaciones del navegador, no un veredicto final sobre la tarea. Revisa los elementos guardados y cualquier resultado o captura que necesite la aplicación antes de eliminar la sesión para solicitar la limpieza del entorno. Las capturas pueden contener información sensible de páginas o cuentas, por lo que la documentación recomienda limitar su acceso a personas autorizadas y excluirlas de los registros de la aplicación. ## El acceso y el coste son decisiones distintas OpenAI indica en su [resumen de DevDay](https://openai.com/index/devday-2026-recap/) que el uso del ordenador está disponible a través de la API y en Codex y ChatGPT Work con Pro 500 y Enterprise. Esta guía trata la vía de la API, que requiere credenciales y permisos de Platform. La información sobre los planes del producto no concede acceso a la API ni incluye sus cargos de uso. La [descripción general de la API de Agents](https://developers.openai.com/api/docs/guides/agents-api/overview) señala que el uso del modelo se factura según las [tarifas de API](https://developers.openai.com/api/docs/pricing) del modelo seleccionado, mientras que los entornos aislados alojados por OpenAI aplican las [tarifas estándar de contenedor](https://developers.openai.com/api/docs/pricing#built-in-tools). Las páginas revisadas no indican una tarifa aparte por la herramienta de uso del ordenador; eso no significa que una sesión de navegador alojada sea gratuita. Comprueba los precios actuales de los modelos y contenedores antes de calcular el presupuesto de una ejecución. Los ejemplos utilizan métodos de la API beta que pueden cambiar. Para este artículo no se creó ninguna sesión de API, no se ejecutó ninguna tarea de navegador ni se utilizó ningún SDK. ## Fuentes y lecturas adicionales - [OpenAI, «Uso del ordenador»](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use), consultado el 30 de septiembre de 2026. Referencia principal para la configuración del navegador, los nombres de eventos, las solicitudes de origen y autenticación, la comprobación de resultados, la actividad y la eliminación. La página no mostraba fecha de publicación. - [OpenAI, «Inicio rápido de la API de Agents»](https://developers.openai.com/api/docs/guides/agents-api/quickstart), consultado el 30 de septiembre de 2026. Especifica los permisos de claves de Platform, la cabecera beta y los requisitos previos del SDK; su ejemplo general de programación es distinto del recorrido de uso del ordenador. - [OpenAI, «API de Agents»](https://developers.openai.com/api/docs/guides/agents-api/overview) y [«Entornos aislados alojados por OpenAI»](https://developers.openai.com/api/docs/guides/agents-api/environments/openai-hosted), consultados el 30 de septiembre de 2026. Explican el modelo de sesión y la facturación separada del modelo y del contenedor alojado. Ninguna de las dos páginas indicaba una fecha de publicación. - [Precios de la API de OpenAI](https://developers.openai.com/api/docs/pricing), consultados el 30 de septiembre de 2026. Deben comprobarse las tarifas actuales del modelo elegido y del contenedor alojado; aquí no se estima el coste de una ejecución concreta. - [OpenAI, «Resumen de DevDay 2026»](https://openai.com/index/devday-2026-recap/), publicado el 29 de septiembre de 2026. Fuente del lanzamiento y de las declaraciones separadas de OpenAI sobre la disponibilidad mediante API y en los planes Pro 500 y Enterprise de Codex/ChatGPT Work. ## Sources - [Uso del ordenador | API de OpenAI](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use) — Referencia principal para tareas de navegador: entorno alojado, nombres de eventos y aprobaciones, verificación de resultados, actividad, capturas y eliminación. Es documentación, no una prueba de BIG CHANGE. - [Inicio rápido de la API de Agents | API de OpenAI](https://developers.openai.com/api/docs/guides/agents-api/quickstart) — Permisos de claves de aplicación de Platform, configuración del SDK, cabecera beta y ciclo de vida de la sesión. El ejemplo general de programación es distinto del tutorial de uso del ordenador. - [API de Agents | API de OpenAI](https://developers.openai.com/api/docs/guides/agents-api/overview) — Documenta el modelo de sesión gestionada y los cargos separados por uso del modelo, herramientas de OpenAI y entornos aislados alojados. - [Entornos aislados alojados por OpenAI | API de OpenAI](https://developers.openai.com/api/docs/guides/agents-api/environments/openai-hosted) — Confirma las tarifas estándar de contenedor para los entornos aislados alojados por OpenAI, la facturación separada del modelo y la eliminación para solicitar la limpieza del entorno. - [Precios | API de OpenAI](https://developers.openai.com/api/docs/pricing) — Tarifas actuales de modelos y contenedores. Las páginas revisadas no indican una tarifa específica por la herramienta de uso del ordenador; no se calcula ningún coste por ejecución. - [Resumen de DevDay 2026 | OpenAI](https://openai.com/index/devday-2026-recap/) — Anuncio del proveedor sobre el uso del ordenador en la API de Agents y la disponibilidad diferenciada en la API y en los planes Pro 500 y Enterprise de Codex/ChatGPT Work.