A OpenAI, na sua recapitulação do DevDay, de 29 de setembro, anunciou o Computer Use na Agents API. O nosso guia de lançamento do DevDay 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, 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 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; 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 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 indica que a utilização do modelo é faturada segundo as tarifas da API do modelo selecionado, enquanto as sandboxes alojadas pela OpenAI utilizam as tarifas padrão de contentores. 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», 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», 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» e «OpenAI-hosted sandboxes», 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, 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», 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.