OpenAI의 Agents API가 공개 베타에 들어갔습니다. 다만 기존 모델 호출보다 저렴한 대체재도, 바로 가져다 쓸 수 있는 자동화 플랫폼도 아닙니다. OpenAI는 에이전트 하네스를 관리하고, 개발자는 실행 환경과 도구, 운영 범위를 직접 선택하는 구조입니다.
핵심만 먼저: 무엇이 출시됐고, 누가 주목해야 할까
OpenAI는 2026년 9월 10일 개발자를 위한 공개 베타로 Agents API를 발표했습니다. 공식 발표에 따르면 Codex 하네스와 모델, 도구, 선택한 샌드박스를 조합해 클라우드 에이전트를 실행할 수 있는 관리형 방식입니다.
이미 장시간 실행되고 여러 도구를 사용하는 에이전트를 만들고 있는 팀이라면 특히 유용합니다. 반면 범위가 명확한 요청이라면 Responses API를 한 번 호출하고 간단한 애플리케이션 루프를 붙이는 편이 더 단순할 수 있습니다.
| 질문 | 답변 |
|---|---|
| 사용할 수 있나? | 가능합니다. 다만 GA가 아닌 공개 베타입니다 |
| Agents API 전용 플랫폼 이용료가 따로 있나? | OpenAI는 없다고 밝혔습니다. 단, 모델과 도구 사용료는 발생합니다 |
| 애플리케이션 코드를 OpenAI가 전부 실행하나? | 아닙니다. OpenAI 호스팅, 파트너, 자체 호스팅 실행 환경 중에서 선택합니다 |
| OpenAI가 관리하는 범위는? | 오케스트레이션과 장시간 세션 처리를 포함한 에이전트 하네스입니다 |
| 프로덕션에 바로 쓸 수 있나? | 통제된 파일럿에는 적합하지만, 베타인 만큼 롤백 계획이 필요합니다 |
구조는 실행 환경 선택으로 이해하면 된다
Agents API는 추론 루프와 실제 작업이 실행되는 장소를 분리합니다. 하네스가 세션과 컨텍스트, 도구 선택, 위임을 관리하는 동안 샌드박스는 코드를 실행하고 파일을 다루거나 결과물을 생성합니다.
이 경계에 관한 기준은 OpenAI의 아키텍처 문서입니다. 출시 관련 보도에서는 다음 파트너 실행 환경을 언급합니다. Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle, Runloop, Vercel입니다. 각 서비스의 가격과 지역별 지원 범위는 서로 다릅니다.
| 실행 방식 | 잘 맞는 경우 | 주요 트레이드오프 |
|---|---|---|
| OpenAI 호스팅 샌드박스 | 빠른 프로토타이핑과 관리형 실행이 필요할 때 | 인프라 제어 범위가 좁음 |
| 파트너 샌드박스 | 기존 공급자 관계가 있거나 특정 배포 형태가 필요할 때 | 공급자별 가격과 동작이 다름 |
| 자체 호스팅 환경 | 기존 보안, 네트워크, 인프라 요건을 그대로 유지해야 할 때 | 신뢰성과 운영을 더 많이 직접 책임져야 함 |
네트워크 정책, 시크릿, 데이터 레지던시, 파일시스템 제어가 필수라면 자체 호스팅을 선택하는 편이 낫습니다. 반대로 속도가 더 중요하다면 관리형 실행 환경을 검토할 수 있습니다. 단, 패키지 구성, 타임아웃, 영속성, 결과물 처리 방식이 요구사항을 만족하는지 먼저 테스트해야 합니다.
시크릿과 파일, 네트워크 접근, 영속 상태 같은 거버넌스 결정은 여전히 각 팀의 몫입니다.
베타에서 실제로 달라지는 점
Agents API 개요와 관련 문서는 한 번의 모델 호출을 넘어서는 작업을 겨냥한 여러 기능을 소개합니다.
장시간 세션과 컨텍스트 압축
자동 컨텍스트 압축은 긴 실행 중 컨텍스트가 계속 커지는 문제를 완화하는 데 도움이 됩니다. 다만 OpenAI는 모든 작업에 적용되는 압축률이나 최대 실행 시간을 보장하지 않습니다. 실제 도입 전에는 대표적인 워크로드로 직접 측정해야 합니다.
도구 검색과 병렬 호출
도구 검색을 사용하면 매번 모든 도구 정보를 모델 컨텍스트에 넣지 않아도 됩니다. 서로 독립적인 호출이라면 프로그래밍 방식의 병렬 도구 호출로 전체 처리 시간을 줄일 수 있습니다. 그렇다고 의존성이 있는 호출까지 병렬화할 수 있는 것은 아닙니다. 도구 B의 결과를 받은 뒤 도구 C를 호출해야 한다면 해당 워크플로는 여전히 순차적으로 처리해야 합니다.
멀티 에이전트 위임
주 에이전트가 다른 에이전트에 하위 작업을 위임할 수 있으며, 여러 작업을 병렬로 진행하는 것도 가능합니다. 범위가 명확한 조사, 분류, 결과물 생성에 유용한 방식입니다. 다만 실패 경로와 과금 경로도 함께 늘어나므로, 애플리케이션 설계 단계에서 서브에이전트 수와 최대 턴 수를 제한해야 합니다.
실행 환경
문서에는 OpenAI 호스팅 샌드박스와 자체 호스팅 샌드박스가 설명되어 있습니다. 선택하기 전에 정확히 사용할 공급자를 기준으로 패키지 설치, 파일시스템 영속성, 네트워크 정책, 인증 정보, 타임아웃, 결과물 처리 방식을 검증해야 합니다.
비용 구조: 플랫폼 이용료가 없어도 무료는 아니다
OpenAI의 설명에 따르면 베타 기간에는 Agents API 자체에 별도 이용료가 붙지 않습니다. 그래도 모델 토큰, 내장 또는 외부 도구, 샌드박스 인프라 비용은 청구될 수 있습니다.
| 비용 항목 | 예산에 반영할 내용 |
|---|---|
| 모델 호출 | 모든 턴과 서브에이전트에서 발생하는 입력 및 출력 토큰 |
| 내장 도구 | 해당되는 경우 도구별 사용량 |
| 샌드박스 | 컴퓨팅, 스토리지, 네트워크 또는 공급자 이용료 |
| 애플리케이션 운영 | 로그, 큐, 데이터베이스, 모니터링, 재시도 비용 |
독립적인 A8gent 비용 분석은 호출 한 번만 기준으로 비용을 계산하면 왜곡될 수 있는지 보여줍니다. 월 1,000건의 트리아지 실행, 실행당 입력 토큰 3,000개와 출력 토큰 400개라는 조건에서, 호스팅 비용을 제외한 모델 토큰 비용을 gpt-5-nano 기준 월 약 $0.31, gpt-5.6-sol 기준 약 $27로 추산했습니다. 이는 해당 글이 특정 시점에 계산한 수치이며, Agents API의 공식 가격 견적은 아닙니다.
멀티턴 워크플로는 이후 턴에 누적 컨텍스트가 포함되기 때문에 단일 호출 기준의 추산보다 비용이 커집니다. 예산은 자체 사용 데이터를 기준으로 정해야 합니다.
안전한 파일럿이라면 최대 턴 수를 정하고, 동시 실행 수를 제한하며, 완료된 비즈니스 결과별 토큰 사용량을 기록해야 합니다. 실행 한 건당 지출 한도도 강제하는 편이 좋습니다. OpenAI Cookbook의 실행별 지출 제어 예제는 가격이 가상의 수치라고 명시하지만, 패턴 자체는 참고할 만합니다. 각 요청 전에 최악의 경우를 가정한 금액을 예약하고, 요청이 끝난 뒤 실제 사용량을 기준으로 정산하는 방식입니다.
도입 전에 답해야 할 프로덕션 질문
베타 API와 연동 방식, 사용 한도는 바뀔 수 있습니다. 따라서 새로운 실행을 중단하더라도 원본 데이터가 손상되지 않는 폴백 경로를 마련해야 합니다.
초기 사용자 중 한 명인 @yandt888은 미국 데이터 레지던시와 자체 호스팅 실행 환경, 제로 데이터 보존 요건 사이의 관계에 대한 우려를 제기했습니다. 이는 사용자가 보고한 우려일 뿐 OpenAI의 정책을 의미하지는 않습니다. 규제 대상 데이터를 전송하기 전에는 해당 계정에 적용되는 최신 계약 조건과 지역별 약관을 직접 확인해야 합니다.
도입 전에 다음 항목을 확인하세요.
- 실패한 실행을 외부 작업의 중복 없이 재개할 수 있는가.
- 세션 기록과 파일, 결과물이 어디에 저장되는가. 공급자 장애가 발생하면 어떻게 처리되는가.
- 서브에이전트의 판단 과정을 추적하고 입력을 재현할 수 있는가. 베타 계약이 바뀌었을 때 다른 시스템으로 이전할 수 있는가.
데모는 어디까지나 데모로 다뤄야 합니다. 되돌릴 수 없는 작업에는 승인 절차를 두고, 가능한 도구는 멱등적으로 설계하세요. 실제 연동 환경에서 프롬프트 인젝션과 부분 실패 시나리오도 테스트해야 합니다.
현실적인 도입 기준
도구와 세션, 전문화된 에이전트 사이에서 판단이 필요한 작업을 조율하는 일이 가장 어렵다면 Agents API를 우선 검토할 만합니다. 문서 분류, 내부 조사, 결과물 생성처럼 범위가 명확한 작업부터 시작한 뒤, 직접 유지해야 하는 더 단순한 루프와 결과를 비교해보세요.
| 우선순위가… | 먼저 시작할 것 |
|---|---|
| 관리형 오케스트레이션에 빠르게 접근하는 것 | Agents API 파일럿 |
| 워크플로 상태를 최대한 직접 제어하는 것 | 자체 오케스트레이션 계층 |
| 공급자 종속성을 최소화하는 것 | 모델 비종속 프레임워크 또는 게이트웨이 |
| 높은 수준의 승인과 감사 추적 | 에이전트 주변에 워크플로 엔진 구축 |
| 저렴하고 예측 가능한 단일 턴 호출 | 모델 API 직접 호출 |
파일럿을 시작할 때는 성공 지표 하나, 작업당 최대 비용 하나, 최대 실행 시간 하나, 사람의 승인 지점 하나를 정하세요. 관리형 하네스가 개발 시간을 눈에 띄게 줄이거나 복구 동작을 개선하지 못한다면, 이를 새로운 베타 의존성으로 채택할 이유는 없습니다.
OpenAI Agents API FAQ
OpenAI Agents API는 정식 출시됐나요?
아닙니다. OpenAI는 2026년 9월 10일 공개 베타로 발표했습니다. 출시 자료에는 정식 출시 일정이 안내되어 있지 않습니다.
자체 샌드박스를 사용할 수 있나요?
가능합니다. OpenAI는 OpenAI 호스팅 및 파트너 환경과 함께 자체 호스팅 환경도 선택지로 문서화하고 있습니다. 다만 보안과 네트워킹, 영속성, 운영에 대한 책임은 각 팀이 더 많이 맡게 됩니다.
멀티 에이전트 워크플로를 지원하나요?
지원합니다. API는 서브에이전트로의 위임과 병렬 작업을 지원합니다. 에이전트가 하나 늘어날 때마다 지연 시간과 토큰 사용량, 실패 요인이 증가할 수 있으므로 명확한 제한을 설정해야 합니다.