OpenAI Agents API

관리형 Codex 하네스로 작업을 이어가는 클라우드 에이전트를 구축할 수 있으며, OpenAI가 세션·오케스트레이션·컨텍스트 압축·복구를 맡음 애플리케이션이 도구와 실행 환경을 선택하면, 에이전트는 샌드박스에서 코드 실행·파일 편집·MCP 연결·산출물 생성을 수행함 세션 상태 유지로 대화 맥락을 다시 구성하지 않고 여러 턴에 걸쳐 작업을 이어가며, 실행 중 방향 조정과 하위 에이전트 위임도 가능함 비용은 선택한 모델의 API 요금, OpenAI 도구의 표준 요금, OpenAI 호스팅 샌드박스의 표준 컨테이너 요금에 따라 청구됨 데이터 레지던시는 현재 미국만 지원하며 Zero Data Retention(ZDR)은 지원하지 않음 — 자체 호스팅 샌드박스를 선택해도 이 제약은 달라지지 않음 관리형 Codex 하네스와 역할 분담 Agents API를 통해 OpenAI가 관리하는 Codex 하네스(harness)에 접근할 수 있음 OpenAI는 세션, 오케스트레이션, 컨텍스트 압축, 복구를 담당함 애플리케이션은 사용할 도구를 제공하고 실행 환경을 선택함 샌드박스 안에서 코드 실행, 파일 편집, MCP 서버 연결, 산출물 생성이 가능함 관리형 하네스는 작업 실행부터 위임·재개까지 지원함 샌드박스에서 명령과 코드를 실행하고, 작업에 맞는 스킬과 지침을 적용함 도구 또는 MCP를 통해 외부 데이터에 연결할 수 있음 작업 중 에이전트의 방향을 조정하고, 이전 작업을 요약해 컨텍스트 창을 관리함 작업을 나누어 하위 에이전트에 위임하고, 중단한 지점부터 세션을 재개할 수 있음 다른 실행 방식과의 차이는 에이전트 런타임 비교에서 확인할 수 있음 네 가지 핵심 개념과 세션 흐름 API는 네 가지 개념을 중심으로 구성됨 Agent: 에이전트가 사용할 모델, 지침, 도구, MCP 서버를 정의함 Environment: 파일 접근, 스킬 로드, 명령 실행에 사용하는 선택적 샌드박스 또는 컴퓨터임 Session: 작업을 수행하고 입력에 응답하는, 상태가 지속되는 에이전트 인스턴스임 Events and items: 에이전트에 보낸 입력과 세션 중 생성한 출력을 나타냄 OpenAI 호스팅 샌드박스를 사용하는 빠른 시작은 세션 생성부터 후속 작업까지 다음 순서로 진행함 에이전트를 설정해 세션을 생성하면 OpenAI가 환경을 준비함 환경이 준비된 뒤 사용자 입력을 보내면 작업 턴이 시작됨 출력을 스트리밍하거나 웹훅으로 완료 또는 추가 입력 필요 여부...