Edição Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Configure uma tarefa de navegador na Agents API com o Computer Use da OpenAI

> Este guia, baseado na documentação, explica como criar uma sessão de navegador na OpenAI Agents API, tratar pedidos relativos à origem dos sites, verificar o resultado e eliminar a sessão.

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.

A OpenAI, na sua [recapitulação do DevDay, de 29 de setembro](https://openai.com/index/devday-2026-recap/), anunciou o Computer Use na Agents API. O nosso [guia de lançamento do DevDay](https://bigchange.ai/blog/openai-devday-2026-launches-availability-guide) aborda o lançamento mais amplo. Para um programador, a tarefa imediata é mais limitada do que a de um agente de navegador genérico: abrir uma página pública, recolher uma resposta específica e ter em conta o que o navegador acedeu. O [guia de Computer Use](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use), consultado a 30 de setembro, documenta este percurso através de uma sessão de navegador alojada. A BIG CHANGE analisou a documentação, mas não executou a API.

A aplicação cria a sessão, envia a entrada, acompanha os eventos, apresenta ao utilizador os pedidos relativos à origem dos sites, verifica a resposta e limpa o ambiente. O agente pode operar o navegador no ambiente alojado. A conclusão de um turno não demonstra que a informação pedida esteja correta.

## A grande mudança

A nova via de Computer Use da OpenAI na Agents API oferece aos programadores uma sessão de navegador alojada, um fluxo de eventos, decisões do utilizador sobre a origem dos sites, registos da atividade do navegador e a limpeza através da API. Para uma tarefa limitada a uma página pública, a integração prática consiste em tratar cada etapa explicitamente e verificar o título e o URL devolvidos. O acesso a uma origem, a conclusão de um turno e a correção da resposta são três observações distintas.

## Comece com uma chave de API e uma sessão de navegador

O [início rápido da Agents API](https://developers.openai.com/api/docs/guides/agents-api/quickstart#prerequisites) requer uma chave de API da aplicação num projeto da OpenAI Platform. Especifica `api.agents.read` e `api.agents.write` para operações de sessão e `api.responses.write` para inferência do modelo. Exporte a chave como `OPENAI_API_KEY` no ambiente da aplicação e mantenha-a fora da sandbox do agente. Utilize um SDK atual da OpenAI com a Agents API beta; o exemplo passo a passo em JavaScript do guia de Computer Use utiliza `openai` e `prompt-sync`. A alternativa em cURL requer Bash e `jq` e o cabeçalho explícito `OpenAI-Beta: agents=v1`.

A configuração de sessão documentada coloca `{ "type": "computer_use" }` em `agent.tools`, define `environment.type` como `openai_hosted` e ativa `environment.desktop.enabled`. O exemplo para páginas públicas também ativa o acesso à rede e define `include_screenshots: true` na ferramenta. A criação da sessão devolve um identificador para pedidos posteriores de eventos e itens; não inicia a tarefa do navegador. Guarde esse identificador antes de continuar. O exemplo do guia pede ao agente que encontre o início rápido da Agents API e devolva o título e o URL da página, sem iniciar sessão nem alterar dados do site.

## Siga a tarefa e decida a que sites pode aceder

Abra o fluxo de eventos da sessão antes de enviar a entrada da tarefa, para que a aplicação possa receber os primeiros eventos. A entrada documentada é um `agent.session.input.message`. Quando o fluxo indicar `agent.session.requires_action`, obtenha o `required_actions` atual da sessão e identifique os registos `computer_use_approval_request` pendentes. Para um pedido de `browser_origin_access`, mostre ao utilizador a origem pedida e qualquer justificação indicada. Envie a decisão dele — `approve`, `deny` ou `cancel` — como um objeto `agent.session.input.computer_use_approval_request_result` com o `request_id` correspondente.

Essa decisão diz respeito ao acesso à origem de um site, incluindo quando se trata de um site público. Definir `network.access` como `enabled` não concede a autorização. A autorização para uma origem também não confirma cada ação posterior do navegador. A OpenAI indica que as aplicações que precisam de garantir uma confirmação antes de compras ou alterações destrutivas devem limitar o navegador alojado a recursos incapazes de realizar essas ações ou utilizar um ambiente de navegador que controlem. O texto dos sites é uma entrada não fidedigna e não pode autorizar acessos nem sobrepor-se às instruções do utilizador.

O percurso para páginas públicas cancela um pedido separado de `browser_authentication`. Uma tarefa que necessite de uma conta tem o seu próprio fluxo de [fluxo de início de sessão](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use#handle-sign-in); esta configuração só de leitura não o abrange. A OpenAI também observa que cancelar um pedido de autorização não cancela a tarefa. Uma resposta de autorização aceite significa que a decisão foi recebida, não que a navegação tenha terminado.

## Verifique o resultado, reveja a atividade e elimine a sessão

O fluxo de eventos pode fornecer texto de resposta em `agent.session.turn.output_text.done`. Aguarde por `agent.session.turn.completed` para o turno principal, tratando separadamente os eventos de falha e cancelamento. Na tarefa documentada, confirme se a resposta contém efetivamente o título e o URL do início rápido. O simples fecho do fluxo não demonstra que o turno tenha terminado; a OpenAI recomenda aos programadores que recuperem a mesma sessão após uma falha de ligação ou quando o resultado for incerto.

Os itens da sessão fornecem uma segunda perspetiva sobre o trabalho do navegador. Os itens `computer_use_call` incluem um título de atividade, o ID do turno e o estado. Com as capturas de ecrã ativadas, um item pode incluir um URL de imagem `computer_screenshot`; algumas operações continuam a não devolver uma imagem. Esses itens mostram as operações do navegador, não uma conclusão definitiva sobre a tarefa. Reveja os itens guardados e qualquer resultado ou captura de ecrã de que a aplicação precise antes de eliminar a sessão e pedir a limpeza do ambiente. As capturas de ecrã podem conter informação sensível de páginas ou contas; a documentação recomenda restringir o acesso a pessoas autorizadas e mantê-las fora dos registos da aplicação.

## Acesso e custo são decisões separadas

A OpenAI afirma na sua [recapitulação do DevDay](https://openai.com/index/devday-2026-recap/) que o Computer Use está disponível através da API e no Codex e no ChatGPT Work para os planos Pro 500 e Enterprise. Este guia aborda a via da API, que exige credenciais e permissões da Platform. A indicação sobre os planos dos produtos não concede acesso à API nem inclui custos de utilização da API.

A [visão geral da Agents API](https://developers.openai.com/api/docs/guides/agents-api/overview) indica que a utilização do modelo é faturada segundo as [tarifas da API](https://developers.openai.com/api/docs/pricing) do modelo selecionado, enquanto as sandboxes alojadas pela OpenAI utilizam as tarifas padrão de [contentores](https://developers.openai.com/api/docs/pricing#built-in-tools). As páginas consultadas não indicam uma tarifa separada para a ferramenta Computer Use; isso não significa que uma sessão de navegador alojada seja gratuita. Consulte os preços atuais do modelo e do contentor antes de estimar o custo de uma execução. Os exemplos utilizam métodos beta da API, que podem mudar. Este artigo não inclui uma sessão de API, tarefa de navegador ou execução do SDK.

## Fontes e leituras adicionais

- [OpenAI, «Computer use»](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use), consultado a 30 de setembro de 2026. Referência primária para a configuração do navegador, nomes dos eventos, pedidos de autorização relativos à origem e à autenticação, verificação de resultados, atividade e eliminação. A página não indica uma data de publicação.
- [OpenAI, «Agents API quickstart»](https://developers.openai.com/api/docs/guides/agents-api/quickstart), consultado a 30 de setembro de 2026. Especifica as permissões da chave da OpenAI Platform, o cabeçalho beta e os requisitos do SDK; o exemplo geral de programação é distinto do guia de navegador.
- [OpenAI, «Agents API»](https://developers.openai.com/api/docs/guides/agents-api/overview) e [«OpenAI-hosted sandboxes»](https://developers.openai.com/api/docs/guides/agents-api/environments/openai-hosted), consultadas a 30 de setembro de 2026. Explicam o modelo de sessão e a faturação separada da utilização do modelo e dos contentores alojados. Nenhuma das páginas indica uma data de publicação.
- [Preços da API OpenAI](https://developers.openai.com/api/docs/pricing), consultados a 30 de setembro de 2026. É necessário verificar os preços atuais do modelo e do contentor selecionados; não se estima aqui o custo de uma execução específica.
- [OpenAI, «DevDay 2026 Recap»](https://openai.com/index/devday-2026-recap/), publicado a 29 de setembro de 2026. Fonte do anúncio e das declarações distintas da OpenAI sobre a disponibilidade na API e nos planos Pro 500 e Enterprise do Codex/ChatGPT Work.

## Sources

- [Computer use | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use) — Referência primária para tarefas de navegador no ambiente alojado, nomes de eventos e autorizações, verificação de resultados, atividade, capturas de ecrã e eliminação. Documentação, não um teste da BIG CHANGE.
- [Agents API quickstart | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/quickstart) — Permissões das chaves de aplicação na Platform, configuração do SDK, cabeçalho beta e ciclo de vida da sessão. O exemplo geral de programação é distinto do passo a passo de Computer Use.
- [Agents API | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/overview) — Documenta o modelo de sessão gerida e os custos separados da utilização do modelo, das ferramentas da OpenAI e das sandboxes alojadas.
- [OpenAI-hosted sandboxes | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/environments/openai-hosted) — Confirma as tarifas padrão de contentores para sandboxes alojadas pela OpenAI, a faturação separada do modelo e a eliminação para pedir a limpeza do ambiente.
- [Pricing | OpenAI API](https://developers.openai.com/api/docs/pricing) — Preços atuais do modelo e do contentor. As páginas consultadas não indicam uma tarifa específica para Computer Use; não é apresentada uma estimativa por execução.
- [DevDay 2026 Recap | OpenAI](https://openai.com/index/devday-2026-recap/) — Anúncio do fornecedor sobre Computer Use na Agents API e sobre a disponibilidade distinta na API e nos planos Pro 500 e Enterprise do Codex/ChatGPT Work.