추가 요금 없이 하네스를 빌린다: OpenAI Agents API가 요구하는 자체 구축 재검토

하네스 네 조각을 API 뒤로 숨겼다

OpenAI는 2026년 9월 10일 Agents API를 공개 베타로 열면서, 그동안 팀이 직접 짜야 했던 코덱스 하네스를 관리형 런타임으로 내놓았다. 에이전트·환경·세션·이벤트 네 개념으로 모델-도구 루프, 세션 유지, 컨텍스트 압축과 복구를 서비스가 대신 처리한다. 회귀 게이트나 권한 샌드박스처럼 팀이 따로 쌓아 온 하네스 구성 요소 중 상당수가 API 호출 하나 뒤로 들어간 셈이다.

요금표에 없는 비용

가격 정책은 토큰과 도구 사용량 외 별도 하네스 요금이 없다고 안내한다. 실제 비용은 다른 곳에서 발생한다. 코드 실행·파일 편집이 이뤄지는 환경(environment)은 OpenAI 호스팅 또는 Blaxel·Cloudflare·Daytona·DigitalOcean·E2B·Modal·Oracle·Runloop·Vercel 등 아홉 개 파트너 샌드박스 중에서 고르게 되는데, 이 선택이 곧 종속이다. 컨텍스트 압축 로직도 벤더가 관리하므로 실패 원인을 직접 들여다볼 방법이 줄어든다.

구축 로드맵과 함정: 자체 하네스냐 매니지드 API냐 판단 게이트

(a) 판단 기준부터 숫자로 잡는다. 자체 하네스 유지보수에 분기당 드는 인시간, 매니지드 전환 시 예상 절감 시간, 샌드박스 파트너 교체에 걸려도 되는 한도(예: 5영업일 이내)를 먼저 표로 만든다. 이 표가 없으면 전환 논의는 "간편해 보인다"는 인상에서 멈춘다.

(b) 실패 패턴 넷을 미리 정리한다. 첫째, 무조건 매니지드로 옮겨 이미 구축한 회귀 게이트·권한 샌드박스 자산을 버리고 벤더 문서부터 다시 따라가는 경우. 둘째, 반대로 자체 구축을 고집해 이미 검증된 컨텍스트 압축·복구 기능을 처음부터 재구현하다 출시가 늦어지는 경우. 셋째, 아홉 개 파트너 중 하나에 코드를 묶어 두고 이전 계획 없이 운영하다 그 파트너의 가격·리전 정책 변경에 발목 잡히는 경우. 넷째, 세션·이벤트 로그 스키마가 벤더 쪽에 고정돼 있어 자사 관측 대시보드의 필드와 어긋나는 경우다.

복구 분기는 이중 기록에서 시작한다. 세션 상태를 벤더 로그와 별도로 자사 로그에도 병행 기록해 두면, 한 샌드박스 파트너에서 다른 파트너로 옮길 때 인수인계 데이터를 잃지 않고 재개할 수 있다. 매니지드 API의 응답 스키마와 자사 관측 필드 사이에 매핑 계층을 따로 두면 벤더가 필드를 바꿔도 대시보드까지 깨지지는 않는다.

(c) 전환 전 운영 체크리스트는 네 갈래로 짠다. 이벤트·세션 로그 필드가 자사 관측 표준과 매핑되는지, 컨텍스트 압축 정책이 문서로 공개돼 디버깅 가능한지, 샌드박스 파트너를 바꿀 때 실제로 손대야 할 코드 범위가 얼마나 되는지, 매니지드 쪽 장애 시 되돌아갈 최소 기능의 자체 하네스 경로가 남아 있는지를 배포 전에 확인한다.

(d) 이 판단은 한 번으로 끝나지 않는다. 분기마다 자체 유지보수 인시간과 매니지드 요금(토큰·도구 사용량)을 다시 비교하고, 벤더의 API 변경 로그를 별도로 추적해 어떤 변경이 지난 분기의 판단을 흔들었는지 다음 검토에 반영한다.

바로 쓰는 체크리스트

매니지드 하네스는 요금표에 하네스 항목이 없을 뿐, 종속 비용은 샌드박스 파트너 선택과 컨텍스트 압축의 불투명성으로 옮겨 간다. 유지보수 인시간과 전환 절감 시간을 숫자로 비교하고, 로그 매핑 계층과 폴백 경로를 미리 갖추면 아홉 개 파트너 중 하나가 바뀌어도 팀의 판단 기준은 그대로 남는다.

참고 링크

Introducing the Agents API and hosted sandboxes — OpenAI Developer Community