OpenAI Cookbook에서 애플리케이션 관리 방식과 웹훅 관리 방식의 예제를 확인하세요.
프로비저닝 방식을 선택하세요.
- 애플리케이션 관리 방식: 애플리케이션이 직접 E2B 샌드박스를 생성하고 연결합니다.
- 웹훅 관리 방식: OpenAI 웹훅을 수신하면 샌드박스를 시작하거나 다시 연결하는 핸들러를 배포하세요.
두 방식을 비교하려면 샌드박스 수명 주기를 참고하세요.
시작하기 전에
E2B_API_KEY를 설정하고 애플리케이션 요청에는 OPENAI_API_KEY를 사용하세요. OPENAI_EXECUTOR_API_KEY의 값을 환경 키로 설정하고, 샌드박스에는 이 키만 CODEX_API_KEY로 전달하세요.
웹훅 관리 방식
OpenAI 웹훅을 검증하고 세션마다 별도의 E2B 워커를 프로비저닝하는 컨트롤러를 구현하세요. 자격 증명 설정, 엔드포인트 등록, 서명 검증은 핸들러 배포 및 연결의 절차를 따르세요.
각 세션에 어떤 샌드박스가 연결되어 있는지 영구 저장하세요. 연결 요청을 받으면 해당 워커가 일시 중지된 경우 실행을 재개하고, 삭제된 경우 새 워커로 교체하세요. 워커를 일시 중지하면 파일이 유지되지만 교체하면 기존 파일이 유지되지 않습니다. 컨트롤러와 워커의 실행 시간 제한을 설정하고, 컨트롤러 사용을 중단할 때는 OpenAI 웹훅을 삭제하세요.
애플리케이션 관리 방식
애플리케이션에서 E2B SDK 또는 API를 사용해 다음과 같이 샌드박스를 관리하세요.
- 자체 호스팅 세션을 생성하고 해당 세션의 환경 ID를 저장하세요.
- 세션의 작업 디렉터리가 있는 격리된 E2B 샌드박스를 생성하고 그 안에 Codex CLI를 설치하세요.
- 환경 ID와 환경 키를 사용해 샌드박스에서 실행기를 시작하세요.
- 세션 실행 및 이어가기를 참고해 입력을 보내고 해당 턴의 결과를 확인하세요.
- 작업을 마치면 세션을 삭제하고 E2B 샌드박스를 중지하세요.
샌드박스 수명은 실행기 명령어의 시간 제한과 별도로 설정하세요. 명령어에 시간 제한이 없어도 샌드박스는 수명이 만료되면 중지됩니다.
참고 자료
- E2B 문서 보기
- E2B Python SDK 보기
- E2B TypeScript SDK 보기