OpenAI Agents API 사용법|Codex 하네스·장기 실행·MCP·서브에이전트
OpenAI는 2026년 9월 10일 Agents API를 공개 베타 로 출시했습니다. Agents API는 단순히 모델의 답변을 반환하는 API가 아니라, Codex에 사용되는 에이전트 하네스를 통해 장기 작업과 도구 호출, 파일 작업, MCP 연결, 서브에이전트 협업을 관리하는 API입니다. OpenAI가 세션·오케스트레이션·컨텍스트 압축·복구를 관리하고, 개발자는 모델·도구·실행환경과 실제 업무 흐름을 선택하는 구조입니다. 다만 현재는 정식 출시 단계가 아닌 공개 베타이므로 API 형식과 지원 범위가 변경될 가능성을 고려해야 합니다. 먼저 결론 Agents API 는 OpenAI가 관리하는 Codex 하네스로 오래 실행되는 에이전트를 만들 때 적합합니다. 애플리케이션 내부에서 에이전트 실행 루프와 승인·저장 방식을 직접 제어하려면 Agents SDK , 모델 응답과 도구 호출을 가장 낮은 수준에서 직접 구성하려면 Responses API 가 더 적합합니다. 정보 기준일: 2026년 9월 11일 목차 Agents API란 무엇인가 Responses API·Agents SDK 차이 실행환경 선택 방법 장기 세션과 작업 이어가기 MCP 연결 구조 서브에이전트 사용법 Agents API 최소 JavaScript 예제 비용·권한·보안 점검 공개 베타 주의사항 자주 묻는 질문 Agents API란 무엇인가 Agents API는 애플리케이션에서 OpenAI가 관리하는 Codex 하네스 를 호출할 수 있게 만든 API입니다. 하네스는 모델에 질문을 한 번 전달하는 데서 끝나지 않고, 작업 계획을 세우고 도구를 선택하며 필요한 명령을 실행하고 결과를 확인하는 반복 과정을 관리합니다. Agents API의 기본 구성요소는 다음 네 가지입니다. Agent: 사용할 모델·지침·도구·MCP 서버를 정의합니다. Environment: 명령 실행, 파일 처리, 코드 실행에 사용하는 선택적 환경입니다. ...