OpenAI Agents API - Codex 기반 에이전트를 내 앱에 연결하기

애플리케이션에서 Codex의 에이전트 실행 기능을 API로 이용할 수 있으며, OpenAI가 세션 관리, 작업 조율, 문맥 압축과 복구를 맡음 개발자가 도구와 실행 환경을 지정하면 에이전트가 코드 실행, 파일 편집, 외부 서비스 연결과 산출물 생성을 수행함 같은 세션에서 이전 작업을 이어가고, 실행 도중 추가 지시로 방향을 바꾸거나 하위 에이전트에 작업을 나눠 맡길 수 있음 작업에 필요한 스킬과 지침을 적용하고, 도구와 MCP 서버를 통해 애플리케이션의 데이터와 기능에 연결할 수 있음 OpenAI 호스팅 샌드박스 또는 자체 호스팅 환경을 선택할 수 있으며, 장애 대응, Slack 봇, 데이터 분석과 문서 검토 등의 구현 예제를 제공 에이전트 실행과 관리는 OpenAI가, 도구와 환경은 개발자가 Agents API는 Codex가 작업을 수행하는 실행 체계인 하네스(harness)를 애플리케이션에서 API로 이용할 수 있게 함 OpenAI는 세션 관리, 작업 조율, 문맥 압축과 복구를 담당하고, 개발자는 에이전트가 사용할 도구와 실행 환경을 지정함 에이전트는 샌드박스에서 명령과 코드를 실행하고 파일을 편집하며, 도구와 MCP 서버로 외부 데이터를 가져와 산출물을 만들 수 있음 작업에 맞는 스킬과 지침을 적용하고, 복잡한 일은 하위 에이전트에 나눠 맡길 수 있음 작업 도중 추가 지시로 방향을 바꾸거나, 중단했던 세션을 이어서 진행할 수 있음 다른 실행 방식과의 차이는 에이전트 런타임 비교에서 확인할 수 있음 상태를 유지하며 이어지는 작업 세션 API는 다음 네 가지 개념으로 구성됨 Agent: 사용할 모델, 지침, 도구와 MCP 서버 설정 Environment: 파일을 읽고 스킬을 불러오며 명령을 실행하는 선택적 샌드박스 또는 컴퓨터 Session: 이전 작업의 상태를 유지하며 입력에 응답하는 에이전트 인스턴스 Events and items: 에이전트에 전달한 입력과 세션에서 생성한 출력 OpenAI 호스팅 환경에서는 에이전트를 설정해 세션을 만들면 OpenAI가 샌드박스를 준비하고, 사용자 입력을 받은 뒤 작업을 시작함 애플리케이션은 출력을 스트리밍으로 받거나 웹훅으로 작업 완료와 추가 입력 필요 여부를 확인함 작업이 끝난 뒤에도 같은 세션에 후속 요청을 보낼 수 있어, 대화 맥락을 매번 다시 구성할 필요가 없음 전체 흐름은 빠른 시작, 실행 환경별 설정과 제약은 환경 옵션에서 확인할 수 있음 모델과 도구, 실행 ...