OpenAI Agents API 공개 베타…실행 환경은 개발자가 고른다
OpenAI가 2026년 9월 10일 Agents API를 모든 개발자 대상 공개 베타로 출시했다. OpenAI의 출시 발표 에 따르면 이 API는 Codex를 구동하는 관리형 하네스를 제공하지만, 코드를 실행할 환경은 OpenAI 호스팅 샌드박스·개발자 자체 인프라·제휴 샌드박스 가운데 개발자가 선택한다.
같은 날짜의 공개 베타 출시와 세 실행 경로는 9월 11일 게재된 The File의 독립 보도 에서도 확인된다. 실제 사용 흐름은 모델·지시문·도구·환경을 지정해 세션을 만들고 작업을 보내는 방식이지만, 관리형이라는 표현이 보안·스토리지·외부 시스템 권한까지 OpenAI가 대신 책임진다는 뜻은 아니다.
OpenAI가 맡는 하네스, 개발자가 맡는 실행 조건
Agents API의 핵심 경계는 하네스와 실행 환경의 분리다. OpenAI는 세션 상태, 모델과 도구의 오케스트레이션, 컨텍스트 압축, 중단된 작업의 복구를 관리한다. 개발자는 이를 직접 구현하는 부담을 줄일 수 있지만, 에이전트가 어떤 모델과 도구를 쓰고 어디에서 명령을 실행할지는 애플리케이션 설정으로 결정해야 한다.
역할을 구분하면 다음과 같다.
- OpenAI 관리: 세션 오케스트레이션, 컨텍스트 압축과 복구, 관리형 Codex 하네스의 유지·개선.
- 개발자 설정: 모델, 지시문, MCP 서버와 사용자 정의 함수, 실행 환경, 파일·패키지·스킬, 서브에이전트 사용 범위.
- 개발자 책임: 외부 시스템 인증과 최소 권한, 입력 데이터의 적법성, 결과 검증, 로그·승인·비용 통제.
- 환경 제공자 범위: 컴퓨팅 자원, 격리, 스토리지와 비밀정보 처리 조건. 구체적인 책임은 선택한 환경과 계약에 따라 달라진다.
따라서 자체 인프라를 연결해도 관리형 하네스까지 기업 내부로 옮겨지는 것은 아니다. 반대로 OpenAI 호스팅 샌드박스를 골라도 업무 데이터의 사용 근거, 연결된 SaaS의 권한, 에이전트가 만든 결과의 검수 책임이 자동으로 OpenAI에 이전되지는 않는다.
세 실행 환경은 배치 위치보다 책임 범위가 다르다
OpenAI 호스팅 샌드박스에서는 OpenAI가 실행 환경을 프로비저닝하고 관리한다. 에이전트는 이 환경에서 코드를 실행하고 파일을 편집하며 산출물을 만들 수 있다. 개발자는 필요한 파일과 패키지, 스킬과 플러그인을 구성하되 컨테이너 자체를 배포하는 작업은 줄일 수 있다.
자체 인프라는 기업이 샌드박스와 작업 디렉터리를 제공하는 방식이다. 실행 이미지, 운영체제 패치, 네트워크 접근, 파일 지속성, 비밀정보 주입, 용량과 장애 대응을 직접 통제해야 하는 조직에 맞지만 그만큼 운영 책임도 커진다. 세션과 하네스는 계속 OpenAI 관리 API를 통해 작동한다.
제휴 샌드박스는 OpenAI 하네스에 외부 제공자의 실행 환경을 연결한다. 공개된 제휴사는 Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle, Runloop, Vercel이며, 관리형 배포나 VPC 배포, 파일·비밀정보 저장 방식, CPU·GPU·메모리 구성, 콜드 스타트와 비용 조건은 제공자마다 다르다.
선택 기준은 단순한 호스팅 선호가 아니다. 빠른 실험에는 OpenAI 호스팅 환경이 간결하고, 네트워크 경계와 실행 이미지를 직접 통제해야 한다면 자체 인프라가 유력하다. 특정 클라우드 배치나 VPC, 하드웨어 조건이 필요하면 제휴 환경을 비교해야 하며, 어느 경로든 조직의 보안·감사·데이터 처리 요건을 별도로 대조해야 한다.
장기 세션 기능은 묶였지만 업무 통제는 남는다
Agents API 공식 개요 문서 는 OpenAI가 세션·오케스트레이션·컨텍스트 압축·복구를 관리하고 애플리케이션이 도구와 실행 환경을 제공한다고 명시한다. 같은 문서는 모델 사용량에는 선택한 모델의 API 요금, OpenAI 도구에는 표준 도구 요금, OpenAI 호스팅 샌드박스에는 컨테이너 요금이 적용되며, 현재 데이터 리전은 미국만 지원하고 Zero Data Retention은 지원하지 않는다고 설명한다.
컨텍스트 압축은 세션이 한도에 가까워질 때 이전 작업에서 계속 필요한 정보를 남겨 장시간 작업을 이어 가는 기능이다. 도구 검색은 모든 도구 정의를 처음부터 컨텍스트에 싣는 대신 현재 작업과 관련된 정의를 필요할 때 불러온다. 토큰 사용을 줄이는 데 도움을 줄 수 있지만 실제 절감 폭은 등록한 도구 수와 호출 패턴에 좌우된다.
서브에이전트는 복잡한 작업을 독립된 하위 과제로 나눠 병렬 처리한다. 각 하위 에이전트는 별도 컨텍스트를 유지하고 주 에이전트가 결과를 모은다. 조사나 코드 분석처럼 분리가 가능한 작업의 시간을 줄일 수 있는 대신, 동시 모델 호출과 도구·컴퓨팅 사용량이 늘 수 있다.
기존의 단순 모델 호출에서는 애플리케이션이 반복 실행, 상태 전달, 도구 호출과 복구 흐름을 직접 구성한다. Agents API는 이 가운데 장기 세션과 하네스 운영을 관리형 계층으로 옮긴다. 그러나 업무 규칙, 연결 데이터, 쓰기 권한, 사람의 승인 지점과 결과 검증은 여전히 애플리케이션 설계에 남는다.
도입 흐름은 세션 생성보다 권한 설계가 먼저다
기본 흐름은 에이전트의 모델·지시문·도구를 정하고 실행 환경을 선택한 뒤 세션을 생성하는 순서다. 입력을 보내 작업을 시작하면 스트리밍 이벤트나 웹훅으로 진행 상태를 받을 수 있고, 같은 세션에 후속 입력을 보내 작업을 이어 가거나 실행 중 방향을 조정할 수 있다.
- 에이전트가 읽거나 변경할 데이터와 외부 시스템을 목록화하고 읽기·쓰기 권한을 분리한다.
- 코드 실행 필요성과 데이터 경계를 기준으로 OpenAI 호스팅, 자체 인프라, 제휴 환경 중 하나를 고른다.
- 모델과 도구, MCP 서버, 서브에이전트의 범위를 세션 구성에 반영한다.
- 완료·실패·추가 입력 요청을 처리할 스트리밍 또는 웹훅 경로를 마련한다.
- 세션과 산출물의 삭제·보존, 로그 접근, 비용 경보, 외부 쓰기 전 사람의 승인 조건을 정한다.
공개 베타에서는 API 동작과 필드가 정식 출시 전 바뀔 가능성도 운영 계획에 넣어야 한다. 베타용 요청 조건과 SDK 버전을 고정하고 변경 기록과 호환성을 확인할 필요가 있다. 이는 기능을 시험하는 단계와 실제 고객 데이터나 쓰기 권한을 연결하는 단계를 분리해야 하는 이유이기도 하다.
비용은 API가 아니라 세션 전체로 계산해야 한다
Agents API에 별도 추가 이용료가 없다는 안내는 실행이 무료라는 의미가 아니다. 모델 토큰, 내장 도구, OpenAI 호스팅 컨테이너가 각각 과금 대상이며, 자체 인프라나 제휴 환경을 선택하면 해당 사업자의 컴퓨팅·스토리지·네트워크 비용도 더해진다.
비용 추정 단위도 한 번의 사용자 요청보다 세션 전체가 적절하다. 장기 작업은 여러 차례 모델과 도구를 호출할 수 있고, 서브에이전트 병렬화는 처리 시간을 줄이는 대신 동시 사용량을 늘릴 수 있다. 컨텍스트 압축과 도구 검색은 불필요한 컨텍스트를 줄이는 장치이지 지출 상한을 자동으로 보장하는 기능은 아니다.
데이터 통제에서는 샌드박스 위치와 API 세션의 보존 조건을 구분해야 한다. 자체 인프라에서 코드를 실행하더라도 Agents API 자체가 ZDR 대상이 되는 것은 아니다. 국내 기업은 개인정보나 기밀정보를 연결하기 전에 실행 환경뿐 아니라 세션 상태와 산출물의 저장·삭제 조건, 국외 이전 요건을 함께 검토해야 한다.
현재 확인된 상태는 모든 개발자가 이용할 수 있는 공개 베타이며, OpenAI가 관리형 Codex 하네스를 운영하고 개발자가 실행 환경을 선택하는 구조다. 정식 출시 일정과 베타 이후의 가격 정책, 미국 외 데이터 리전 및 ZDR 지원 계획은 아직 공개되지 않았다. 도입 판단에서는 기능 수보다 실행 환경별 책임 경계, 데이터 조건, 세션 단위 총비용을 먼저 비교할 필요가 있다.
함께 읽기:
뉴스레터 구독
최신 Web3, AI, 암호화폐 뉴스를 이메일로 받아보세요.