Introducing the Agents API
🖼️ 인포그래픽
🖼️ 4컷 인포그래픽
💡 한 줄 요약
OpenAI는 Codex의 에이전트 실행 제어 체계인 하네스와 인프라를 제공하는 Agents API를 공개 베타로 출시해, 개발자가 실행 환경을 선택하고 장시간 작업하는 에이전트를 구축할 수 있도록 했다.
📌 핵심 요약
- Agents API는 작업, 모델, 도구, 환경을 지정하는 단일 API 호출로 프로덕션용 에이전트를 생성할 수 있다고 소개하며, OpenAI가 하네스를 호스팅하고 유지·관리한다.
- 개발자는 OpenAI 관리형 샌드박스, 자체 인프라, 파트너 샌드박스를 선택할 수 있으며, OpenAI hosted sandbox에는 파일, 패키지, 스킬, 플러그인을 구성할 수 있다.
- Agents API는 컨텍스트 한도에 가까워지면 이전 내용을 자동 압축하고, 모델 출시마다 개선된 하네스 기능에 버전별 접근을 제공한다.
- Tool search와 programmatic tool calling은 필요한 도구 정의 로딩, 병렬 호출, 작업 연결, 결과 필터링·결합을 지원하며, 서브에이전트는 독립적인 컨텍스트로 병렬 작업을 수행한다.
- Agents API는 오픈소스 Codex 하네스를 기반으로 모든 개발자에게 공개 베타로 제공된다. API 자체의 추가 요금은 없으며 사용한 토큰과 도구에 비용을 지불하고, 정식 출시를 향해 피드백을 반영할 예정이다.
🧩 주요 포인트
- OpenAI의 하네스 운영과 실행 환경 선택권 결합 → 개발자가 실행 제어 체계의 유지 부담을 덜고 고유한 도구·지식·워크플로에 집중할 기반 제공.
- 컨텍스트 자동 압축·도구 처리·서브에이전트 병렬화 통합 → 장시간 작업과 대량 데이터 처리를 위한 자체 구현 부담 완화.
- 오픈소스 Codex 기반의 공개 베타와 토큰·도구 과금 → 핵심 로직을 살펴볼 수 있으며, 도입 시 베타 단계와 실제 사용량 비용을 함께 고려할 필요.
🧠 상세 정리
1. 장시간 실행 경험을 개발자용 API로 확장
OpenAI는 Codex와 ChatGPT for Work를 전 세계 수백만 명에게 제공하면서, 장시간 실행되는 에이전트에 필요한 조건을 배웠다고 설명한다. 유용한 에이전트에는 컨텍스트를 관리하고 도구를 효율적으로 사용하며 서브에이전트를 조율하는 강력한 하네스가 필요하다는 것이다. 또한 며칠 동안 안정적으로 실행을 이어가고, 파일 작업과 코드 실행, 중간 결과 저장을 지원하는 인프라도 필요하다고 강조한다. Agents API의 공개 베타는 이러한 경험을 바탕으로 Codex를 구동하는 동일한 하네스와 인프라를 간단하고 유연한 API 형태로 개발자에게 제공한다.
2. 단일 호출로 생성하고 실행 환경은 선택
Agents API는 작업, 모델, 도구, 환경을 지정하면 단일 API 호출로 프로덕션용 에이전트를 생성할 수 있다고 소개한다. OpenAI가 하네스를 호스팅하고 유지·관리하며, 개발자는 OpenAI 관리형 샌드박스와 자체 인프라, 파트너 샌드박스 중 실행 환경을 선택한다. 파트너에는 Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle, Runloop, Vercel이 포함된다. 이 통합은 완전 관리형 환경이나 VPC 내부 배포, 파일·비밀정보 저장 방식, CPU·GPU·메모리 구성 등 서로 다른 요구를 지원한다. 개발자는 성능, 콜드 스타트, 비용 특성을 워크플로에 맞추면서 에이전트 고유의 도구와 지식, 작업 흐름에 집중할 수 있다는 설명이다.
3. OpenAI hosted sandbox의 작업 환경
빠르게 시작하고 효율적으로 확장하려는 개발자를 위해 OpenAI hosted sandbox도 함께 소개한다. 이 환경은 Codex와 ChatGPT를 구동하는 것과 동일한 샌드박싱 인프라를 활용하며, OpenAI가 샌드박스를 프로비저닝하고 관리한다. 에이전트는 이 안에서 코드를 실행하고 파일을 다루며 결과물을 생성할 수 있고, OpenAI는 이를 안전하고 성능이 우수한 환경으로 설명한다. 개발자는 작업에 필요한 파일, 패키지, 스킬, 플러그인을 유연하게 구성할 수 있다. 따라서 관리형 환경을 선택하더라도 에이전트가 작업을 완료하는 데 필요한 자료와 기능을 제공할 수 있도록 설계되어 있다.
4. 모델과 함께 개선되는 하네스와 컨텍스트 관리
새로운 모델 기능을 활용하려면 하네스를 다시 손봐야 하는 경우가 많고, 그만큼 애플리케이션 개선에 쓸 시간이 줄어든다는 점이 다음 문제로 제시된다. Agents API는 모델 출시마다 이러한 기능에 대한 버전별 접근을 제공하며, OpenAI가 모델과 함께 하네스를 지속적으로 유지·개선한다. 장시간 세션을 위한 주요 기능은 컨텍스트 관리로, 세션이 컨텍스트 한도에 가까워지면 이전 내용을 자동으로 압축하면서 작업을 계속하는 데 필요한 정보를 보존한다. 이를 통해 개발자는 별도의 압축 로직을 구현하지 않고도 여러 컨텍스트 창에 걸친 워크플로를 구축할 수 있다. 원문은 이 기능을 모델이 여러 시간 동안 작업하도록 지원하는 기반으로 설명한다.
5. 도구 사용 효율화와 서브에이전트 병렬 작업
Tool search는 관련 도구 정의를 필요할 때 불러와 모델의 캐시를 유지하면서 토큰 사용량과 비용을 줄이는 데 도움을 준다. 도구가 준비되면 programmatic tool calling으로 호출을 병렬 실행하고 연관 작업을 연결하며, 코드에서 결과를 필터링하거나 결합해 필요한 결과만 컨텍스트로 가져올 수 있다. Agents API는 MCP와 사용자 정의 함수, 웹 검색 같은 내장 도구를 지원한다. 다중 에이전트 지원은 복잡한 작업을 독립적인 부분으로 나누어 각자 별도 컨텍스트를 유지하는 서브에이전트에 위임하고, 주 에이전트가 작업을 조율해 결과를 모으는 방식이다. 원문은 자체 조율 체계를 구축하지 않아도 병렬 작업에 적합한 연구·분석·코딩의 속도를 높일 수 있다고 설명한다.
6. 오픈소스 기반, 공개 베타와 과금
Agents API는 오픈소스 Codex 하네스를 기반으로 하며, 개발자는 공개 코드베이스에서 모델 호출과 도구, 컨텍스트를 조율하는 핵심 로직을 살펴보고 배울 수 있다. API를 사용하는 동안 해당 하네스의 운영과 유지·관리는 OpenAI가 맡는다. 발표에 따르면 Agents API는 모든 개발자에게 공개 베타로 제공되며, API 사용 자체에 대한 추가 요금 없이 에이전트가 사용한 토큰과 도구에 대해 비용을 지불한다. OpenAI는 정식 출시를 향해 공개 베타 기간 동안 피드백을 바탕으로 빠르게 개선하겠다고 밝혔다. 이를 위해 잘 작동하는 부분, 사용 중 겪는 어려움, 프로덕션에서 에이전트를 구축하고 운영하는 데 필요한 사항을 알려 달라고 요청한다.
🧾 핵심 주장 / 시사점
- Agents API는 하네스 운영을 OpenAI에 맡기면서도 실행 환경을 선택할 수 있게 해, 관리 부담 완화와 환경별 요구 대응을 함께 추구한다.
- 컨텍스트 자동 압축, 필요한 도구만 로딩하는 방식, 독립 컨텍스트를 가진 서브에이전트는 긴 작업을 지속하고 처리 범위를 넓히는 상호 보완적 기능이다.
- API 자체의 추가 요금이 없다는 설명은 무료 실행을 뜻하지 않으며, 토큰과 도구 사용량이 비용 판단의 기준으로 남는다.
✅ 액션 아이템
- Agents API 적용 시 OpenAI 관리형 샌드박스, 자체 인프라, 파트너 샌드박스 중 작업에 맞는 실행 환경 검토.
- 장시간 작업에 대한 컨텍스트 자동 압축과 서브에이전트 병렬화의 적합성 확인.
- Agents API의 공개 베타 단계를 고려하고 토큰·도구 사용량에 따른 비용 검토.
❓ 열린 질문
- OpenAI 관리형 샌드박스, 자체 인프라, 파트너 샌드박스 중 대상 작업에 가장 적합한 실행 환경은 무엇인가?
- 컨텍스트 자동 압축과 서브에이전트 병렬화는 대상 장시간 작업에서 어느 정도 효과를 내는가?
- Agents API 공개 베타를 적용할 때 예상되는 토큰과 도구 사용 비용은 얼마인가?
