Markdown 버전

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

# OpenAI 컴퓨터 사용 기능으로 Agents API 브라우저 작업 설정하기

> OpenAI Agents API 브라우저 세션을 만들고, 웹사이트 출처 요청을 처리하고, 결과를 확인한 다음 세션을 삭제하는 방법을 문서에 근거해 안내합니다.

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.

OpenAI는 9월 29일 [DevDay 회고에서](https://openai.com/index/devday-2026-recap/) Agents API의 컴퓨터 사용 기능을 발표했습니다. 더 넓은 출시 내용은 [DevDay 출시 안내](https://bigchange.ai/blog/openai-devday-2026-launches-availability-guide)에서 다룹니다. 개발자가 당장 처리할 작업은 범용 브라우저 에이전트보다 범위가 좁습니다. 공개 페이지를 열고, 특정 답을 수집하고, 브라우저가 무엇에 접근했는지 기록하는 일입니다. 9월 30일에 확인한 OpenAI의 [컴퓨터 사용 안내](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use)는 호스팅 브라우저 세션으로 이 과정을 설명합니다. BIG CHANGE는 문서를 검토했으며 API를 실행하지는 않았습니다.

애플리케이션은 세션을 만들고 입력을 보내며 이벤트를 추적하고, 웹사이트 출처 접근 요청을 사용자에게 보여 주고, 답을 확인한 뒤 정리 작업을 합니다. 에이전트는 호스팅 환경 안에서 브라우저를 조작할 수 있습니다. 한 턴이 완료되었다고 요청한 정보가 정확하다는 뜻은 아닙니다.

## 큰 변화

OpenAI의 새 Agents API 컴퓨터 사용 기능은 이벤트 스트림이 있는 호스팅 브라우저 세션, 웹사이트 출처에 대한 사용자 결정, 브라우저 활동 기록, API를 통한 정리 기능을 개발자에게 제공합니다. 범위가 정해진 공개 페이지 작업을 통합할 때는 각 단계를 명시적으로 처리하고 반환된 제목과 URL을 확인하는 것이 실용적입니다. 출처 접근, 턴 완료, 답변의 정확성은 서로 다른 관찰 결과입니다.

## API 키와 브라우저 세션부터 시작하세요

OpenAI의 [Agents API 빠른 시작](https://developers.openai.com/api/docs/guides/agents-api/quickstart#prerequisites)은 OpenAI Platform 프로젝트의 애플리케이션 API 키를 요구합니다. 세션 작업에는 `api.agents.read` 및 `api.agents.write`를, 모델 추론에는 `api.responses.write`를 지정합니다. 애플리케이션 환경에서 키를 `OPENAI_API_KEY` 로 내보내고 에이전트의 샌드박스 밖에 보관하세요. 베타 Agents API를 지원하는 최신 OpenAI SDK를 사용하세요. 컴퓨터 사용 안내의 JavaScript 예제에서는 `openai`와 `prompt-sync`를 사용합니다. cURL 대안에는 Bash, `jq` 및 명시적인 `OpenAI-Beta: agents=v1` 헤더가 필요합니다.

문서에 나온 세션 구성은 `{ "type": "computer_use" }`을 `agent.tools` 안에 두고, `environment.type`을 `openai_hosted`로 설정하며, `environment.desktop.enabled`을 활성화합니다. 공개 페이지 예제는 네트워크 접근도 활성화하고 도구에 `include_screenshots: true`을 설정합니다. 세션 생성은 이후의 이벤트 및 항목 요청에 사용할 ID를 반환하지만 브라우저 작업을 시작하지는 않습니다. 계속하기 전에 ID를 저장하세요. 안내의 예제는 에이전트에게 Agents API 빠른 시작 페이지를 찾아 페이지 제목과 URL을 반환하라고 요청하며, 로그인하거나 사이트 데이터를 변경하지 않습니다.

## 작업을 추적하고 접근 가능한 사이트를 결정하세요

애플리케이션이 초기 이벤트를 받을 수 있도록 작업 입력을 보내기 전에 세션 이벤트 스트림을 여세요. 문서에 나온 입력은 `agent.session.input.message`입니다. 스트림에서 `agent.session.requires_action`이 보고되면 세션의 현재 `required_actions`를 가져와 대기 중인 `computer_use_approval_request` 레코드를 찾으세요. `browser_origin_access` 요청이 오면 요청된 출처와 명시된 사유를 사용자에게 보여 주세요. 사용자의 `approve`, `deny` 또는 `cancel` 결정을 `agent.session.input.computer_use_approval_request_result`에 해당하는 `request_id`로 전송합니다.

이 결정은 공개 사이트를 포함한 웹사이트 출처에 대한 접근 권한에 관한 것입니다. `network.access`을 `enabled`로 설정해도 승인을 받은 것은 아닙니다. 출처 승인이 이후의 모든 브라우저 동작을 확인해 주는 것도 아닙니다. 구매나 파괴적인 변경 전에 반드시 확인을 받아야 하는 애플리케이션이라면 해당 동작을 수행할 수 없는 리소스로 호스팅 브라우저를 제한하거나 직접 제어하는 브라우저 런타임을 사용해야 한다고 OpenAI는 설명합니다. 웹사이트의 텍스트는 신뢰할 수 없는 입력이며 접근을 승인하거나 사용자의 지시를 덮어쓸 수 없습니다.

공개 페이지 예제는 별도의 `browser_authentication` 요청을 취소합니다. 계정이 필요한 작업에는 자체 [로그인 절차](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use#handle-sign-in)가 있으며 이 읽기 전용 설정에서는 다루지 않습니다. OpenAI는 승인 요청을 취소해도 작업 자체는 취소되지 않는다고 덧붙입니다. 승인 응답이 수락되었다는 것은 결정이 전달되었다는 뜻이지 탐색이 끝났다는 뜻은 아닙니다.

## 결과를 확인하고 활동을 검토한 뒤 세션을 삭제하세요

이벤트 스트림은 `agent.session.turn.output_text.done`에서 답변 텍스트를 제공할 수 있습니다. 주된 턴에서는 `agent.session.turn.completed`을 기다리고, 실패 및 취소 이벤트는 별도로 처리하세요. 문서의 작업에서는 답변에 빠른 시작 페이지의 제목과 URL이 실제로 포함되어 있는지 확인합니다. 스트림이 닫혔다고 턴이 끝난 것은 아닙니다. 연결이 끊기거나 결과가 불확실하면 같은 세션에서 복구하라고 OpenAI는 안내합니다.

세션 항목은 브라우저 작업을 다른 관점에서 보여 줍니다. `computer_use_call` 항목에는 활동 제목, 턴 ID, 상태가 포함됩니다. 스크린샷을 활성화하면 항목에 `computer_screenshot` 이미지 URL이 들어갈 수 있지만 일부 작업에서는 이미지가 반환되지 않습니다. 이 항목은 브라우저 작업을 보여 줄 뿐 작업의 최종 판정은 아닙니다. 세션을 삭제해 환경 정리를 요청하기 전에 저장된 항목과 애플리케이션에 필요한 결과나 스크린샷을 검토하세요. 스크린샷에는 민감한 페이지 또는 계정 정보가 포함될 수 있으므로 승인된 사용자만 볼 수 있게 하고 애플리케이션 로그에는 남기지 말라고 문서는 권고합니다.

## 접근 권한과 비용은 별개의 결정입니다

OpenAI는 [DevDay recap](https://openai.com/index/devday-2026-recap/)에서 컴퓨터 사용 기능을 API와 Pro 500 및 Enterprise 요금제의 Codex, ChatGPT Work에서 이용할 수 있다고 설명합니다. 이 안내는 Platform 자격 증명과 권한이 필요한 API 경로를 다룹니다. 제품 요금제에 대한 설명이 API 접근 권한을 부여하거나 API 이용 요금을 포함하는 것은 아닙니다.

Agents API [개요](https://developers.openai.com/api/docs/guides/agents-api/overview)에 따르면 모델 사용량은 선택한 모델의 [API 요율](https://developers.openai.com/api/docs/pricing)로 청구되고 OpenAI 호스팅 샌드박스는 표준 [컨테이너 요율](https://developers.openai.com/api/docs/pricing#built-in-tools)을 적용합니다. 검토한 페이지에는 별도의 컴퓨터 사용 도구 요금이 명시되어 있지 않지만, 그렇다고 호스팅 브라우저 세션이 무료라는 뜻은 아닙니다. 실행 예산을 세우기 전에 현재 모델 및 컨테이너 가격을 확인하세요. 예제는 변경될 수 있는 베타 API 메서드를 사용합니다. 이 기사를 위해 API 세션이나 브라우저 작업을 만들거나 SDK를 실행하지 않았습니다.

## 출처 및 더 읽을거리

- [OpenAI, “Computer use”](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use), 2026년 9월 30일 확인. 브라우저 설정, 이벤트 이름, 출처 및 인증 요청, 결과 확인, 활동 기록, 삭제에 관한 주요 참고 자료입니다. 페이지에 게시 날짜는 표시되지 않았습니다.
- [OpenAI, “Agents API quickstart”](https://developers.openai.com/api/docs/guides/agents-api/quickstart), 2026년 9월 30일 확인. Platform 키 권한, 베타 헤더, SDK 사전 요건을 지정합니다. 일반 코딩 예제는 컴퓨터 사용 안내와 별개입니다.
- [OpenAI, “Agents API”](https://developers.openai.com/api/docs/guides/agents-api/overview) 및 [“OpenAI-hosted sandboxes”](https://developers.openai.com/api/docs/guides/agents-api/environments/openai-hosted), 2026년 9월 30일 확인. 세션 모델과 모델 및 호스팅 컨테이너 요금의 별도 청구를 설명합니다. 두 페이지 모두 게시 날짜를 제공하지 않았습니다.
- [OpenAI API 가격](https://developers.openai.com/api/docs/pricing), 2026년 9월 30일 확인. 선택한 모델과 호스팅 컨테이너의 현재 요율을 확인해야 합니다. 여기서는 특정 실행의 비용을 추정하지 않습니다.
- [OpenAI, “DevDay 2026 Recap”](https://openai.com/index/devday-2026-recap/), 2026년 9월 29일 게시. 기능 출시와 API 이용 가능성, Codex/ChatGPT Work Pro 500 및 Enterprise 요금제 이용 가능성에 관한 OpenAI의 별도 설명을 뒷받침합니다.

## Sources

- [Computer use | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/tools/computer-use) — 호스팅 환경, 이벤트 및 승인 이름, 결과 확인, 활동, 스크린샷과 삭제에 대한 브라우저 작업 주요 참고 자료입니다. 문서이며 BIG CHANGE의 테스트 결과가 아닙니다.
- [Agents API quickstart | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/quickstart) — Platform 애플리케이션 키 권한, SDK 설정, 베타 헤더, 세션 수명 주기를 다룹니다. 일반 코딩 예제는 컴퓨터 사용 안내와 구별됩니다.
- [Agents API | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/overview) — 관리형 세션 모델과 모델 사용, OpenAI 도구, 호스팅 샌드박스에 대한 별도 요금을 설명합니다.
- [OpenAI-hosted sandboxes | OpenAI API](https://developers.openai.com/api/docs/guides/agents-api/environments/openai-hosted) — OpenAI 호스팅 샌드박스의 표준 컨테이너 요율, 별도 모델 요금, 환경 정리를 요청하는 삭제 기능을 확인합니다.
- [Pricing | OpenAI API](https://developers.openai.com/api/docs/pricing) — 모델 및 컨테이너의 현재 요율입니다. 검토한 페이지에는 별도의 컴퓨터 사용 도구 요금이 나오지 않으며 실행별 비용도 추정하지 않았습니다.
- [DevDay 2026 Recap | OpenAI](https://openai.com/index/devday-2026-recap/) — Agents API 컴퓨터 사용 기능과 API 및 Codex/ChatGPT Work Pro 500 및 Enterprise 요금제의 개별 이용 가능성에 관한 공급업체 발표입니다.