Edição em Markdown

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

# Configure uma tarefa de navegador com a API Agents e o uso do computador da OpenAI

> Guia baseado na documentação para criar uma sessão de navegador da API Agents da OpenAI, lidar com solicitações de origem de sites, conferir o resultado e excluir 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.

Em 29 de setembro, a [recapitulação do DevDay](https://openai.com/index/devday-2026-recap/) da OpenAI anunciou o uso do computador na API Agents. Nosso [guia de lançamento do DevDay](https://bigchange.ai/blog/openai-devday-2026-launches-availability-guide) aborda o lançamento mais amplo. Para quem desenvolve, a tarefa imediata é mais restrita do que a de um agente de navegador geral: abrir uma página pública, obter uma resposta específica e registrar o que o navegador acessou. O [guia de uso do computador](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use) da OpenAI, consultado em 30 de setembro, descreve esse fluxo por meio de uma sessão de navegador hospedada. A BIG CHANGE analisou a documentação, mas não executou a API.

O aplicativo cria a sessão, envia a entrada, acompanha os eventos, apresenta ao usuário as solicitações de acesso à origem do site, confere a resposta e faz a limpeza. O agente pode operar o navegador no ambiente hospedado. A conclusão de um turno não comprova que as informações solicitadas estejam corretas.

## A grande mudança

O novo caminho de uso do computador na API Agents da OpenAI oferece aos desenvolvedores uma sessão de navegador hospedada com fluxo de eventos, decisões do usuário sobre origens de sites, registros de atividade do navegador e limpeza pela API. Para uma tarefa delimitada em uma página pública, a integração prática é tratar essas etapas explicitamente e verificar o título e a URL retornados. O acesso a uma origem, a conclusão de um turno e a correção da resposta são três observações diferentes.

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

O [guia de início rápido da API Agents](https://developers.openai.com/api/docs/guides/agents-api/quickstart#prerequisites) da OpenAI exige uma chave de API de aplicativo em um projeto da OpenAI Platform. Ele 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 do aplicativo e mantenha-a fora do sandbox do agente. Use uma versão atual do SDK da OpenAI compatível com a API Agents beta; o passo a passo em JavaScript do guia de uso do computador usa `openai` e `prompt-sync`. A alternativa com cURL exige Bash, `jq` e o cabeçalho explícito `OpenAI-Beta: agents=v1`.

A configuração documentada da sessão coloca `{ "type": "computer_use" }` em `agent.tools`, define `environment.type` como `openai_hosted` e ativa `environment.desktop.enabled`. O exemplo de página pública também ativa o acesso à rede e define `include_screenshots: true` na ferramenta. A criação da sessão retorna um ID para as próximas solicitações de eventos e itens; ela não inicia a tarefa no navegador. Salve esse ID antes de prosseguir. O exemplo do guia pede ao agente que encontre a página de início rápido da API Agents e retorne o título e a URL da página, sem entrar em uma conta nem alterar os dados do site.

## Acompanhe a tarefa e decida a quais sites ela pode acessar

Abra o fluxo de eventos da sessão antes de enviar a entrada da tarefa para que o aplicativo possa receber os primeiros eventos. A entrada documentada é um `agent.session.input.message`. Quando o fluxo informar `agent.session.requires_action`, recupere o `required_actions` atual da sessão e identifique os registros pendentes de `computer_use_approval_request`. Para uma solicitação de `browser_origin_access`, mostre ao usuário a origem solicitada e qualquer motivo informado. Envie a decisão dele — `approve`, `deny` ou `cancel` — como um `agent.session.input.computer_use_approval_request_result` com o `request_id` correspondente.

Essa decisão trata do acesso à origem de um site, inclusive quando ele é público. Definir `network.access` como `enabled` não equivale a obter aprovação. A aprovação da origem também não confirma cada ação posterior do navegador. A OpenAI diz que aplicativos que precisam de confirmação garantida antes de compras ou alterações destrutivas devem limitar o navegador hospedado a recursos incapazes de realizar essas ações ou usar um ambiente de navegador que controlem. O texto de sites é uma entrada não confiável e não pode autorizar acesso nem se sobrepor às instruções do usuário.

O passo a passo da página pública cancela uma solicitação separada de `browser_authentication`. Uma tarefa que exige conta tem seu próprio [fluxo de login](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use#handle-sign-in); essa configuração somente de leitura não o abrange. A OpenAI também observa que cancelar uma solicitação de aprovação não cancela a tarefa. Uma resposta de aprovação aceita significa que a decisão foi recebida, não que a navegação terminou.

## Confira o resultado, revise a atividade e exclua a sessão

O fluxo de eventos pode fornecer o texto da resposta em `agent.session.turn.output_text.done`. Aguarde `agent.session.turn.completed` para o turno principal e trate separadamente os eventos de falha e cancelamento. Na tarefa documentada, confira se a resposta realmente contém o título e a URL da página de início rápido. O simples fechamento do fluxo não comprova que o turno terminou; a OpenAI orienta os desenvolvedores a recuperar a mesma sessão após uma falha de conexão ou um resultado incerto.

Os itens da sessão oferecem outra visão do trabalho do navegador. Os itens `computer_use_call` incluem um título de atividade, o ID do turno e o status. Com capturas de tela ativadas, um item pode incluir uma URL de imagem `computer_screenshot`; algumas operações ainda não retornam imagem. Esses itens mostram operações do navegador, não um veredito final sobre a tarefa. Antes de excluir a sessão para solicitar a limpeza do ambiente, revise os itens salvos e qualquer resultado ou captura de que o aplicativo precise. Capturas de tela podem conter informações sensíveis sobre páginas ou contas; por isso, a documentação recomenda restringir o acesso a pessoas autorizadas e mantê-las fora dos registros do aplicativo.

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

Na [recapitulação do DevDay](https://openai.com/index/devday-2026-recap/), a OpenAI afirma que o uso do computador está disponível pela API e no Codex e no ChatGPT Work dos planos Pro 500 e Enterprise. Este guia cobre o caminho pela API, que exige credenciais e permissões da Platform. A informação sobre o plano do produto não concede acesso à API nem inclui cobranças pelo uso da API.

A [visão geral da API Agents](https://developers.openai.com/api/docs/guides/agents-api/overview) informa que o uso do modelo é cobrado pelas [tarifas de API](https://developers.openai.com/api/docs/pricing) do modelo selecionado, enquanto os sandboxes hospedados pela OpenAI usam as [tarifas padrão de contêiner](https://developers.openai.com/api/docs/pricing#built-in-tools). As páginas consultadas não indicam uma cobrança separada pela ferramenta de uso do computador; isso não significa que uma sessão de navegador hospedada seja gratuita. Confira os preços atuais de modelos e contêineres antes de definir o orçamento de uma execução. Os exemplos usam métodos da API beta que podem mudar. Nenhuma sessão de API, tarefa de navegador ou execução de SDK foi realizada para este artigo.

## Fontes e leituras complementares

- [OpenAI, “Computer use”](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use), acessado em 30 de setembro de 2026. Principal referência para configuração do navegador, nomes de eventos, solicitações de origem e autenticação, verificação de resultados, atividade e exclusão. A página não exibia data de publicação.
- [OpenAI, “Agents API quickstart”](https://developers.openai.com/api/docs/guides/agents-api/quickstart), acessado em 30 de setembro de 2026. Especifica as permissões das chaves da Platform, o cabeçalho beta e os pré-requisitos do SDK; o exemplo geral de programação é diferente do passo a passo de uso do computador.
- [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), acessados em 30 de setembro de 2026. Explicam o modelo de sessão e as cobranças separadas do modelo e do contêiner hospedado. Nenhuma das páginas informa data de publicação.
- [Preços da API da OpenAI](https://developers.openai.com/api/docs/pricing), acessados em 30 de setembro de 2026. É preciso conferir as tarifas atuais do modelo escolhido e do contêiner hospedado; não há estimativa de custo para uma execução específica.
- [OpenAI, “DevDay 2026 Recap”](https://openai.com/index/devday-2026-recap/), publicado em 29 de setembro de 2026. Fonte do lançamento e das declarações distintas da OpenAI sobre a disponibilidade pela 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 principal sobre tarefas de navegador: ambiente hospedado, nomes de eventos e aprovações, verificação de resultados, atividade, capturas de tela e exclusã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 aplicativo da Platform, configuração do SDK, cabeçalho beta e ciclo de vida da sessão. O exemplo geral de programação é diferente do passo a passo de uso do computador.
- [Agents API | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/overview) — Documenta o modelo de sessão gerenciada e as cobranças separadas do uso do modelo, das ferramentas da OpenAI e dos sandboxes hospedados.
- [OpenAI-hosted sandboxes | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/environments/openai-hosted) — Confirma as tarifas padrão de contêiner dos sandboxes hospedados pela OpenAI, a cobrança separada do modelo e a exclusão para solicitar a limpeza do ambiente.
- [Pricing | OpenAI API](https://developers.openai.com/api/docs/pricing) — Tarifas atuais de modelos e contêineres. As páginas consultadas não mencionam uma cobrança específica pela ferramenta de uso do computador; não é feita uma estimativa por execução.
- [DevDay 2026 Recap | OpenAI](https://openai.com/index/devday-2026-recap/) — Anúncio do fornecedor sobre o uso do computador na API Agents e a disponibilidade separada pela API e nos planos Pro 500 e Enterprise do Codex/ChatGPT Work.