OpenAI Agents API는 샌드박스 코드 실행, 도구 호출, 하위 작업 위임이 가능한 내구성 있는 상태 저장형 AI 에이전트를 배포할 수 있도록 관리형 Codex 하네스를 제공합니다.
제품의 기능과 공식 포지셔닝
OpenAI Agents API는 애플리케이션이 관리형 서비스로서 Codex 하네스에 프로그래밍 방식으로 접근할 수 있도록 지원합니다. 개발자가 모델, 지침, 도구를 구성하는 동안 세션 지속성, 실행 오케스트레이션, 턴 복구 및 자동 컨텍스트 압축을 처리합니다.
에이전트는 OpenAI 관리형 샌드박스 또는 자체 호스팅 환경 내에서 작동하여 코드를 실행하고, 파일을 편집하며, 아티팩트를 생성합니다. 또한 워크플로는 실시간 제어, 모델 컨텍스트 프로토콜(MCP) 서버를 통한 외부 데이터 연결, 전문화된 하위 에이전트로의 병렬 위임을 지원합니다.
공식 출처로 확인된 활용 사례
인프라 알림을 조사하고 인시던트 데이터를 평가하며 복구 작업을 실행하기 전에 확인을 요청합니다.
샌드박스 환경에서 재현 스크립트를 실행하여 보고된 소프트웨어 버그를 조사하고 결과를 GitHub에 공유합니다.
읽기 전용 SQL을 사용하여 데이터 웨어하우스를 쿼리하고 운영 데이터를 분석하여 비즈니스 질문에 답변합니다.
특정 검사 작업을 전문 하위 에이전트에 위임하여 제출된 문서를 공식 정책 기술 기준에 맞춰 평가합니다.
공식 문서에 안내된 사용 절차
OpenAI가 실행 환경을 프로비저닝하는 동안 에이전트의 모델, 지침, 도구를 구성합니다.
구성된 환경이 준비되면 사용자 입력을 제출하여 작업 턴을 시작합니다.
실행 출력을 스트리밍하거나 웹훅을 수신하여 진행 상황을 추적하고, 에이전트의 입력 대기 또는 완료 시점을 감지합니다.
활성 턴 중에 에이전트를 유도하거나 기존의 지속 가능한 세션에 후속 작업을 제출합니다.
Agents API는 복잡한 실행 로직을 클라이언트 애플리케이션으로부터 추상화하는 관리형 Codex 하네스를 중심으로 작동합니다. 플랫폼은 여러 턴에 걸쳐 영구 세션을 유지하므로 요청마다 이전 대화 이력을 다시 보낼 필요가 없습니다. 또한 모델 컨텍스트 제한을 준수하기 위해 이전 턴을 요약하여 컨텍스트를 자동으로 압축합니다.
실행은 구성된 환경 내에서 이루어지며, OpenAI 호스팅 샌드박스와 자체 호스팅 환경을 모두 지원합니다. 이러한 환경 내에서 에이전트는 로컬 파일 시스템에 접근하고 기능 디렉터리에서 사용자 정의 기술을 로드하며 셸 명령 실행, 모델 컨텍스트 프로토콜(MCP) 서버와의 상호작용 및 생성된 아티팩트 출력을 수행할 수 있습니다.
본인의 자료와 작업 흐름으로 직접 확인할 항목
확인한 출처와 확인 시점
출처를 확인한 제품 정보를 바탕으로 한 답변
에이전트는 OpenAI가 관리하는 OpenAI 호스팅 샌드박스 또는 로컬 기능 디렉터리로 구성된 자체 호스팅 환경 내에서 실행될 수 있습니다.
Agents API는 제로 데이터 보존(ZDR)을 지원하지 않으며, 자체 호스팅 샌드박스를 선택하더라도 ZDR 자격이 부여되지는 않습니다.
Agents API의 데이터 레지던시는 현재 미국 내에서만 독점적으로 지원되며 다른 리전 저장은 제공되지 않습니다.
관리형 Codex 하네스가 자동 컨텍스트 압축 기능을 제공하여 이전 작업을 요약함으로써 활성 컨텍스트 윈도우를 모델 제한 범위 내로 유지합니다.
네, API는 다중 에이전트 실행을 지원하므로 에이전트가 복잡한 작업을 분할하여 동시에 실행되는 하위 에이전트에게 위임할 수 있습니다.
