OpenAI Agents API 공개 베타와 실행 환경 선택

OpenAI가 2026년 9월 10일 Agents API를 모든 개발자 대상 공개 베타로 출시했다. OpenAI의 출시 발표 에 따르면 이 API는 Codex를 뒷받침하는 관리형 하네스와 장기 작업용 인프라를 제공하며, 실행 환경은 OpenAI 관리형 샌드박스, 자체 인프라 또는 제휴 사업자의 환경 중에서 고를 수 있다.

이번 공개 베타에서 개발자는 모델·도구·작업·환경을 지정해 세션을 만들고, OpenAI가 관리하는 에이전트 루프와 선택한 컴퓨팅 환경을 결합할 수 있다. 따라서 도입 조건을 판단하려면 호출 형식뿐 아니라 하네스와 실행 환경의 책임이 어디에서 나뉘는지 먼저 확인해야 한다.

관리형 하네스와 실행 환경은 별도 계층이다

OpenAI Agents API의 세션 관리 계층과 명령을 실행하는 별도 샌드박스의 책임 분리

하네스는 모델 호출을 이어 가는 제어 계층이다. OpenAI는 세션과 오케스트레이션을 운영하고, 세션이 컨텍스트 한도에 가까워지면 이전 내용을 압축하며, 활성화된 경우 독립 작업을 하위 에이전트에 분배하고 결과를 모은다. MCP, 사용자 정의 함수, 내장 웹 검색도 도구로 연결할 수 있다.

실행 환경은 하네스가 요청한 명령을 수행하고 파일과 중간 결과를 보관하는 컴퓨팅 공간이다. OpenAI 호스팅 환경을 쓰면 샌드박스 프로비저닝과 관리가 서비스 범위에 포함되지만, 자체 환경을 연결하면 해당 컴퓨팅 자원의 배치와 운영은 이용 조직의 몫이다. 관리형 하네스를 선택했다고 해서 코드와 파일이 반드시 OpenAI 샌드박스에서 처리되는 것은 아니다.

이 분리는 보안과 장애 대응의 기준도 둘로 나눈다. 세션 지속성, 컨텍스트 관리, 작업 조율은 하네스 계층에서 살펴보고, 패키지 이미지, 네트워크 접근, 비밀정보 주입, 파일 수명과 자원 한도는 실행 환경별로 검토해야 한다. 어느 한쪽의 관리 범위를 다른 계층까지 확대해 해석하면 책임 공백이 생길 수 있다.

첫 호출은 단발 응답이 아니라 세션을 만든다

기본 사용 흐름은 에이전트 세션을 만들면서 모델, 지침, 도구, 실행 환경과 첫 입력을 함께 전달하는 방식이다. 세션은 한 번의 추론 응답보다 긴 작업 단위이므로 같은 세션에 후속 입력을 보내고, 이벤트를 스트리밍하거나 웹훅으로 수신해 진행 상태를 추적할 수 있다.

AgentRiot의 기술 해설 은 2026년 9월 10일 공개 베타 출시를 재확인하고 API 구조를 Agent, Environment, Session, Events and items로 구분한다. Agent는 모델·지침·도구를, Environment는 파일과 명령을 다루는 공간을, Session은 다시 이어서 사용할 수 있는 작업 인스턴스를 나타낸다.

애플리케이션은 세션 생성 이후 환경 준비, 작업 전달, 이벤트 수신, 후속 입력과 종료를 자체 수명 주기에 맞게 연결해야 한다. 이벤트 스트림을 닫는 것과 실행 중인 작업을 취소하는 것은 같은 동작이 아니며, 세션 생성 요청 하나가 재접속이나 산출물 회수 정책까지 자동으로 정해 주는 것도 아니다.

환경 선택은 준비 속도·통제·비용의 배분이다

동일한 에이전트 작업을 관리형 샌드박스와 기업 VPC 환경에서 비교하는 실행 환경 선택 과정

OpenAI 관리형 샌드박스는 별도의 실행 클러스터를 먼저 만들지 않고 기능을 검증하려는 팀에 가장 짧은 도입 경로를 제공한다. OpenAI가 코드 실행, 파일 작업과 산출물 생성을 위한 공간을 프로비저닝하고 관리한다. 다만 실제 데이터를 투입하기 전에는 허용할 네트워크 대상, 비밀정보 전달 방식, 파일 보존 조건이 조직 정책에 맞는지 확인해야 한다.

자체 인프라는 사내 데이터 접근, VPC 경계와 기존 비밀관리 체계를 유지해야 할 때 선택할 수 있다. 실행 자원의 위치와 네트워크 정책을 직접 통제하는 대신 프로비저닝, 이미지 패치, 용량 계획, 관측성, 재접속과 종료 처리를 운영팀이 책임져야 한다. 관리형 하네스가 자체 컴퓨팅의 운영비와 장애 대응까지 대신하는 구조는 아니다.

제휴 환경은 관리형 운영과 배치 통제를 조합하는 선택지다. OpenAI가 제시한 통합 사업자는 Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle, Runloop, Vercel이며, 제공 환경에 따라 VPC 배치, 파일·비밀 저장 방식, CPU·GPU·메모리 구성, 콜드 스타트와 비용 특성이 달라질 수 있다.

빠른 시작: 환경 프로비저닝과 패키지 설치에 걸리는 시간, 첫 작업의 준비 지연을 비교한다.
통제 범위: 데이터 위치, 외부 통신, 사내망 연결, 비밀 저장과 감사 로그의 관리 주체를 구분한다.
비용 구조: 모델 토큰과 도구 사용량에 더해 실행 자원의 가동 시간, 저장공간과 네트워크 비용을 계산한다.
운영 책임: 장애 복구, 보안 패치, 용량 확장과 유휴 자원 종료를 누가 담당하는지 명시한다.

Cloudflare 구현은 세션과 컨테이너의 경계를 보여준다

Codex 세션별 Cloudflare Container가 후속 작업을 이어 간 뒤 유휴 상태에서 종료되는 과정

2026년 9월 10일 공개된 Cloudflare Containers 변경 기록 에 따르면 OpenAI는 세션, 오케스트레이션, 컨텍스트 압축과 복구를 관리하고, 애플리케이션은 도구를 제공하며 Cloudflare Container가 자체 호스팅 실행 환경을 맡는다.

오픈소스 참조 구현의 Worker는 Codex 세션마다 Container를 유지한다. 활성 작업을 계속 실행하고 후속 입력이 들어오면 다시 연결하며, 컨테이너가 유휴 상태가 되면 자동으로 종료한다. 구현을 확장해 컨테이너의 데이터 및 네트워크 접근을 통제하거나 다른 Cloudflare 제품과 연결할 수도 있다.

이 수명 주기는 비용과 재개 지연이 실행 환경의 운영 정책에 달려 있음을 보여준다. 유휴 컨테이너를 종료하면 불필요한 가동 시간을 줄일 수 있지만 다음 작업에서는 환경을 다시 준비해야 할 수 있다. 반대로 환경을 오래 유지하면 후속 입력에 빠르게 대응할 수 있는 대신 대기 자원의 비용을 관리해야 한다.

공개 베타에서 확정된 범위와 남은 조건

확정된 상태는 Agents API가 모든 개발자에게 제공되는 공개 베타라는 점이다. API 자체에 별도 추가 요금은 없고 사용한 토큰과 도구에 따라 비용이 발생하지만, 선택한 실행 환경의 컴퓨팅·저장·네트워크 비용은 해당 환경의 조건과 함께 계산해야 한다. 정식 출시 일정은 제시되지 않았다.

현재 도입 판단의 핵심은 관리형 하네스 채택과 실행 장소를 하나의 결정으로 묶지 않는 데 있다. 초기 검증에는 OpenAI 호스팅 샌드박스를 쓰고, 데이터 위치나 사내망 통제가 필요한 작업은 자체 또는 제휴 환경으로 분리할 수 있다. 공개 베타가 진행되는 동안에는 API 제한과 안정성 조건의 변화, 각 환경의 실제 콜드 스타트와 비용, 데이터 처리 조건을 조직의 작업 부하에서 따로 검증해야 한다.

함께 읽기:

OpenAI Agents API 공개 베타, 실행 환경은 직접 고를 수 있다