한눈에 보기

OpenAI의 Agents API는 Codex 하네스를 OpenAI가 관리하는 API 형태로 애플리케이션에 제공하는 기능입니다. 세션 관리, 오케스트레이션, 컨텍스트 압축, 복구는 OpenAI가 담당하고, 개발자는 도구 제공과 실행 환경 선택에 집중합니다. 에이전트는 샌드박스에서 코드 실행, 파일 편집, MCP 서버 연결, 아티팩트 생성이 가능합니다. 공식 문서 기준으로 핵심 개념은 Agent(모델·지시문·도구·MCP), Environment(샌드박스), Session(지속되는 작업 인스턴스), Events and items(입출력) 네 가지로 구성됩니다.

핵심 내용

매니지드 하네스는 샌드박스에서 명령·코드 실행, 스킬·지시문 적용, 도구나 MCP를 통한 외부 데이터 연결, 작업 중 에이전트 조율(steering), 컨텍스트 창 관리를 위한 이전 작업 요약, 서브에이전트로의 작업 위임, 세션 재개 등을 지원합니다. 세션 생성 시 에이전트 구성(모델, instructions, 도구, multi_agent 설정)과 환경(예: self_hosted 워크스페이스)을 지정하며, 진행 상황은 스트리밍이나 웹훅으로 확인할 수 있습니다. 과금은 선택한 모델의 API 요율, OpenAI 도구는 표준 요율, OpenAI 호스팅 샌드박스는 표준 컨테이너 요율로 문서에 명시되어 있습니다.

활용 관점

문서는 디렉터리 트리 스크립트 실행, 서브에이전트로 릴리스 노트 비교 같은 예제와 함께 인시던트 대응 에이전트, Slack 봇, 읽기 전용 SQL 데이터 분석가, GitHub 이슈 조사자, 정책 스킬 기반 문서 검토기 등 완성된 애플리케이션 예시를 소개합니다. 편집자 의견으로, 세션 상태가 유지되어 대화 컨텍스트를 매번 재구성하지 않아도 되는 점은 여러 턴에 걸친 작업 자동화에 유리해 보입니다. 다만 자체 도구·환경 구성 책임이 애플리케이션 측에 있으므로 도구 설계와 권한 관리가 품질을 좌우할 것입니다.

확인할 점

운영 전 검토가 필요한 사항이 문서에 명시되어 있습니다. 첫째, 현재 데이터 레지던시는 미국만 지원하고 Zero Data Retention(ZDR)은 지원하지 않으며, self-hosted 샌드박스를 선택해도 ZDR 대상이 되지 않습니다. 둘째, API 키 권한과 SDK 설정 등 퀵스타트 사전 요구사항을 확인해야 합니다. 셋째, 매니지드 샌드박스와 셀프 호스팅 환경의 설정 방법과 제약은 환경 옵션 문서에서 별도로 확인해야 하며, 모델명 등 구체적 스펙도 최신 공식 문서로 재확인하는 것이 안전합니다.