Codex와 같은 관리형 하네스를 API로 열어 세션·도구·샌드박스를 한 호출로 구성한다

Agents API, 9월 10일 공개 베타 시작

OpenAI는 2026년 9월 10일 Agents API를 공개 베타로 열었다. Codex와 ChatGPT Work에서 쓰던 에이전트 하네스와 실행 인프라를 개발자 API로 노출하는 형태다.

회사 설명은 단순하다. 오케스트레이션, 장시간 세션, 컨텍스트 관리를 OpenAI가 맡고, 개발자는 도구와 실행 환경과 업무 지시만 정한다. 모든 개발자가 베타에 접근할 수 있고, 정식 출시 일정은 공개하지 않았다.

요청 한 번에 에이전트를 구성한다

  • 세션 생성 요청에 모델, 지시문, 도구, 실행 환경을 넣으면 관리형 하네스가 루프를 돌린다.
  • 공식 문서의 구성 단위는 에이전트, 환경, 세션, 이벤트·항목 네 가지다.
  • 파이썬·타입스크립트 SDK는 beta.agents 네임스페이스를 쓰고, cURL은 OpenAI-Beta: agents=v1 헤더가 필요하다.
  • 애플리케이션 키에는 api.agents.read, api.agents.write, 추론용 api.responses.write 권한이 필요하다.
  • 문서 예시 모델명은 gpt-6-astra다. 베타 시점에 다른 모델 지원 범위는 세션 생성 파라미터로 정해진다.

기존 Responses API와 Agents SDK는 그대로 남는다. OpenAI 문서도 세 경로를 병행 옵션으로 적었다. 장시간 작업을 플랫폼에 맡길지, 루프를 애플리케이션 안에 둘지가 선택 기준이다.

하네스가 세션·압축·복구를 담당한다

직접 에이전트를 만들면 작업 큐, 상태 저장소, 샌드박스 군집, 컨텍스트 압축, 재시도 정책을 각각 운영해야 한다. 파리크 컨설팅의 파리크 자인은 이 부품 수가 줄어드는 점이 Agents API의 실익이라고 말했다.

공개 베타가 넘기는 것은 그 부품이다. 모델 호출과 도구 사용과 세션 유지를 OpenAI가 호스팅한다. 애플리케이션은 작업을 넣고 이벤트를 받으며, 함수 도구가 있으면 그 결과만 돌려준다.

장시간 세션에서 컨텍스트를 압축한다

  • 관리형 하네스는 샌드박스에서 명령과 코드를 실행하고, 스킬·지시문을 적용하며, 도구 또는 MCP로 외부 데이터에 연결한다.
  • 세션이 컨텍스트 한도에 가까워지면 앞선 내용을 요약해 창을 비운다. 여러 창에 걸친 작업을 이어 가게 하려는 설계다.
  • 중단 뒤에는 세션을 이어서 재개할 수 있다고 문서가 적었다. 며칠 단위 실행을 전제로 한 설명이다.
  • 작업 중 에이전트를 조종(steering)하는 인터페이스가 포함된다. 한 번 보낸 뒤 손 놓는 배치와는 다르다.
  • 도구 검색으로 정의만 필요할 때 올리고, 프로그램 방식 호출로 병렬·직렬·필터를 조합해 창 점유를 줄인다.

하위 에이전트에 일을 나눠 맡긴다

  • 멀티에이전트를 켜면 독립 조각을 하위 에이전트에 넘기고, 본 에이전트가 결과를 모은다. 예시 코드는 동시 하위 에이전트 상한을 3으로 둔다.
  • MCP 서버는 하네스가 원격으로 바로 호출할 수 있다. 함수 도구는 애플리케이션이 받아 실행한 뒤 결과를 반환한다.
  • 환경이 없으면 내장 Bash, 패치 적용, 작업 공간 파일, 실행기 MCP는 쓸 수 없다. 코드·파일 작업이 필요하면 환경을 붙여야 한다.
  • 웹훅으로 세션 상태 변화를 받을 수 있어, 스트림을 붙잡아 두지 않고 함수 도구와 자체 환경 수명 주기를 처리할 수 있다.

실행 환경은 호스팅·자체·파트너로 고른다

하네스와 컴퓨트를 분리한 점이 이번 API의 실제 분기점이다. 루프는 OpenAI가 돌리고, 파일과 셸과 패키지가 도는 장소는 개발자가 고른다.

하이파 쪽 인용도 이 분리를 전제로 한다. 하네스와 샌드박스를 나눈 뒤 실패 응답이 줄었다고 밝혔다. 수치가 독립 검증된 것은 아니다.

OpenAI 호스팅 샌드박스를 바로 연다

  • environment.type을 openai_hosted로 두면 OpenAI가 세션용 샌드박스를 만들고 관리한다.
  • 에이전트는 코드 실행, 파일 작업, 산출물 생성을 이 안에서 한다. 패키지·파일·네트워크 접근은 요청 쪽에서 설정한다.
  • 호스팅 샌드박스 요금은 모델 토큰과 별도로 표준 컨테이너 단가가 붙는다.
  • 퀵스타트는 애플리케이션 키를 샌드박스 안에 넣지 말라고 적었다. 실행기 자격 증명과 호출 키를 나누라는 취지다.

자체 인프라에 실행기를 붙인다

  • environment.type이 self_hosted이면 애플리케이션이 환경을 띄우고 실행기를 세션에 연결한다. 사설망·커스텀 소프트웨어가 필요할 때 쓰는 경로다.
  • 프로비저닝, 재연결, 종료, 파일 보존은 애플리케이션 책임이다. 하네스는 명령만 넘긴다.
  • E2B 문서는 애플리케이션이 SDK로 샌드박스를 직접 다루는 방식과, 웹훅 컨트롤러가 세션마다 워커를 만드는 방식을 나눠 적었다.
  • 워커 샌드박스에 들어가는 키는 권한을 줄인 실행기 키로 한정하고, 디스패처 키와 같은 프로젝트에 두라고 E2B가 안내했다.

파트너 9곳이 1차 연동을 제공한다

  • 출시 시점 1차 연동 대상은 블락셀, 클라우드플레어, 데이토나, 디지털오션, E2B, 모달, 오라클, 런루프, 버셀이다.
  • 파트너 쪽은 CPU·GPU·메모리 조합과 VPC 배치, 파일·시크릿 저장 옵션을 상품별로 나눈다. 단가와 SLA는 각 공급자 과금이다.
  • 환경 없는 구성도 가능하다. 그 경우 파일·셸 작업은 애플리케이션 함수 도구로만 흉내 낸다.

OpenAI가 공개한 초기 고객 수치

블로그에 실린 숫자는 고객 인용이다. 표본 크기, 비교 기간, 독립 감사는 공개되지 않았다. 베타 시점의 참고치로 읽는 편이 맞다.

고객 인용이 적은 비용·실패율을 주장한다

  • 세이프티킷은 사례 검토 워크플로를 옮긴 뒤 건당 비용이 60% 줄고 지연과 토큰 효율이 좋아졌다고 밝혔다.
  • 하이파는 하네스와 샌드박스를 분리한 뒤 실패 응답이 86% 줄었다고 했다.
  • 시리대는 평가 점수가 0.71에서 0.85로 올랐고 지연이 4분의 1로 줄었다고 적었다. 하위 에이전트 지원을 이유로 들었다.
  • 드웰리는 수백 개 에이전트에 일을 나눠 비동기로 돌린 뒤 결과를 나중에 모았다고 했다.
  • 롱레이크, 위드커버리지, 딥센스에이아이, 내시닷에이는 구축 시간 단축, 자체 인프라 생략, 저장소 작업, 물류 운영 투입을 각각 언급했다. 공통 측정 단위는 없다.

Agents SDK·응답 API와 역할이 나뉜다

OpenAI는 에이전트 런타임을 세 층으로 적어 두었다. Agents API는 장시간 작업과 세션 저장을 플랫폼이 맡는 경로이고, Agents SDK는 애플리케이션 안에서 루프와 핸드오프를 직접 돌리는 경로이며, Responses API는 모델 호출과 도구를 직접 조립하는 경로다.

통합 공수는 문서 기준으로 API가 낮고 SDK가 중간, Responses가 높다. 상태 보존도 다르다. API는 세션 설정과 턴과 항목을 서비스가 저장하고, SDK는 애플리케이션 저장소에 의존한다.

같은 주 제품 정리에서 Agent Builder는 레거시로 분류됐고, 기존 사용자는 전환 기간만 쓰며 2026년 11월 30일 종료로 안내됐다. 시각 캔버스에서 관리형 런타임으로 무게가 옮겨 가는 일정과 겹친다.

문서가 세 런타임을 병행 옵션으로 둔다

  • Agents API 실행 위치는 OpenAI가 돌리는 관리형 Codex 하네스다. SDK는 애플리케이션 프로세스, Responses는 호출 측 코드다.
  • API 도구 실행은 서비스 연결 도구, 애플리케이션 함수 핸들러, 선택적 샌드박스가 섞인다. SDK 도구는 애플리케이션이 구성한다.
  • 세션·SDK 세션·Responses 대화·샌드박스는 서로 다른 자원이다. 삭제와 산출물 정리 절차가 각각 있다.
  • 스킬, 도구 설계, 프롬프트 캐시는 세 경로에 공통으로 적용된다고 문서가 적었다. 수명 주기만 다르다.

추가 API 요금은 없다고 밝혔다

공개 베타에서 Agents API 자체 구독료는 없다. 모델 토큰, 내장 도구, 호스팅 샌드박스 컨테이너만 기존 단가로 계산한다.

자체·파트너 샌드박스는 컴퓨트 비용이 그 인프라 청구서로 간다. 장시간 루프는 토큰이 세션 동안 반복 청구되므로, API 수수료가 없다고 해서 총비용이 고정되지는 않는다.

앤트로픽 클로드 매니지드 에이전트는 2026년 4월 공개 당시 표준 토큰에 더해 활성 런타임 시간당 0.08달러를 붙였다. 과금 항목 구성이 다르다. OpenAI 베타는 하네스 시간 요금을 따로 두지 않는다고 밝혔다.

데이터 거주지는 미국만 지원한다

개발자 문서는 Agents API의 데이터 거주지를 현재 미국만 지원한다고 적었다. 제로 데이터 리텐션(ZDR)은 지원하지 않는다. 자체 호스팅 샌드박스를 고르더라도 ZDR 대상이 되지 않는다.

세션이 턴과 항목을 저장하는 설계와 ZDR이 충돌한다. 프롬프트와 응답을 요청 처리 후 남기지 않는 계약이 필요한 조직은 이 엔드포인트를 쓰기 어렵다. 인포월드는 의료·금융처럼 보존 정책이 강한 업권에서 채택이 막힐 수 있다고 적었다.

규제 업권 요건과 베타 범위가 어긋난다

  • OpenAI 플랫폼의 ZDR은 적격 API 고객에게 프롬프트·응답을 처리 후 보존하지 않겠다는 약속이다. Agents API는 그 대상에서 빠져 있다.
  • 미국 외 데이터 거주지 프로젝트는 남용 모니터링 변경과 ZDR 부속 합의가 필요한 경우가 많다. 이 API는 그 조합을 아직 열지 않았다.
  • 하네스가 세션 상태를 들고 있으므로, 샌드박스만 고객 VPC에 두어도 오케스트레이션 계층의 보존 위치는 미국 쪽으로 남는다.
  • 파리크 자인은 모델·컨텍스트·도구·오케스트레이션·실행 환경이 한 공급자에 모이면 이전 비용이 커진다고 말했다. 거버넌스 제약과 락인 논점이 같이 나온다.

관리형 에이전트 시장은 이미 열려 있다

2026년 들어 같은 형태의 상품이 여럿 나왔다. 누가 에이전트 루프를 돌리고, 어느 모델만 쓰게 하며, 데이터가 어디에 남는지가 경쟁 축이다.

앤트로픽은 4월 8일 클로드 매니지드 에이전트를 공개했다. 관리형 하네스에 상태·메모리·권한·예약 실행을 붙인 구성이고, 클로드 모델만 쓴다.

AWS는 베드록 에이전트코어를 모델·프레임워크에 덜 묶인 기판으로 두고, 그 위에 오픈AI 하네스를 얹은 매니지드 에이전트 경로를 2026년 4월 제한 프리뷰로 열었다. 루프 작성 주체와 모델 선택 폭이 상품마다 다르다.

같은 주 OpenAI는 금융권용 ChatGPT Work 변종도 발표했다. 모건스탠리·에버코어를 설계 파트너로 두고 GPT-6 Astra와 내장 시세·공시 데이터를 붙인 엔터프라이즈 제품이다. 개발자 API와 업권 워크스페이스가 한 주에 겹쳐 나왔다.

루프를 누가 돌리는지가 상품을 가른다

  • 클로드 매니지드 에이전트는 샌드박스·세션 로그·자격 증명 금고·콘솔 추적을 플랫폼이 제공한다. 모델은 클로드로 고정된다.
  • 베드록 에이전트코어는 런타임·메모리·게이트웨이·아이덴티티·코드 인터프리터를 모듈로 조합하고 모델을 고를 수 있다. 루프 코드는 팀이 가져온다.
  • AWS의 오픈AI 매니지드 에이전트는 에이전트코어를 컴퓨트 기본값으로 쓰되 하네스는 오픈AI 쪽이다. 프론티어 모델 선택 폭이 좁다.
  • OpenAI Agents API는 추가 하네스 시간 요금 없이 토큰·도구·컨테이너만 받는다. 대신 거주지와 ZDR이 베타 범위 밖이다.
  • 인포월드는 마이크로소프트 파운드리 에이전트 서비스와 랭그래프도 같은 비교군에 넣었다. 관리형과 자체 루프 사이의 중간 지대가 남아 있다.

베타 단계에서 비어 있는 운영 지표

공개 문서는 기능 목록과 과금 원칙, 거주지 제약을 분명히 적었다. 프로덕션에서 필요한 사고율, 장기 실행의 실제 토큰 곡선, 권한 남용 빈도, 멀티테넌트 격리 사고는 아직 숫자로 나오지 않았다.

고객 인용 수치도 이 공백을 메우지 못한다. 세이프티킷·하이파·시리대 숫자는 각사 워크로드에 묶여 있고, 실패 정의와 비용 항목이 서로 다르다. 베타 피드백을 받아 정식 출시로 가겠다는 일정만 적혀 있다.

도구와 자격 증명을 세션에 넘기는 순간 사고면은 챗 완성과 달라진다. 실행기 키를 샌드박스에만 넣고 네트워크와 승인 정책을 환경마다 나누는 작업은 여전히 애플리케이션 몫이다. 하네스가 그 경계를 대신 닫아주지는 않는다.

#에이전트#기업 AI#AI 산업

함께 읽기