For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
기본 탐색 메뉴
Theme

Modal

Modal 샌드박스에서 Agents API 세션을 실행하는 방법을 알아보세요.

OpenAI Cookbook에서 애플리케이션 관리 방식과 웹훅 관리 방식의 예제를 확인하세요.

실행기 설정 방법과 연결 요건은 자체 호스팅 샌드박스에서 확인하세요.

프로비저닝 방식을 선택하세요.

  • 애플리케이션 관리 방식: 이 가이드에 따라 애플리케이션에서 샌드박스를 시작하고 중지하세요.
  • 웹훅 관리 방식: OpenAI 웹훅을 받으면 샌드박스를 시작하거나 다시 연결하는 핸들러를 배포하세요.

두 방식의 차이는 샌드박스 수명 주기에서 확인하세요.

시작하기 전에

OpenAI 프로젝트 API 키, Modal 토큰 ID와 시크릿, Codex CLI 패키지가 필요합니다.

애플리케이션에서 요청을 보낼 때는 OPENAI_API_KEY를 사용하세요. OPENAI_EXECUTOR_API_KEY의 값을 환경 키로 설정하고, 샌드박스에는 이 키만 CODEX_API_KEY로 전달하세요.

1. Modal 환경 설정하기

자체 호스팅 세션을 만들고 해당 세션의 환경 ID를 저장하세요. Modal SDK 또는 API를 사용해 지정한 작업 디렉터리로 격리된 샌드박스를 만드세요. 샌드박스에 Codex CLI를 설치한 다음, 저장한 환경 ID와 환경 키로 샌드박스의 실행기를 시작하세요.

2. 세션 실행하기

Modal 실행기가 연결되면 세션 실행 및 이어가기의 HTTP 예제를 따라 입력을 보내고 결과를 스트리밍으로 받으세요. 작업이 끝나면 세션을 삭제하고 Modal 샌드박스도 별도로 중지하세요.

참고 자료