OpenAI Cookbook에서 애플리케이션 관리 방식과 웹훅 관리 방식의 예제를 확인하세요.
실행기 설정 방법과 연결 요구 사항은 자체 호스팅 샌드박스를 참고하세요.
프로비저닝 방식을 선택하세요.
- 애플리케이션 관리 방식: 이 가이드에 따라 애플리케이션에서 샌드박스를 시작하고 중지하세요.
- 웹훅 관리 방식: OpenAI 웹훅을 받으면 샌드박스를 시작하거나 다시 연결하는 핸들러를 배포하세요.
두 방식의 차이는 샌드박스 수명 주기에서 확인하세요.
시작하기 전에
샌드박스에 액세스할 수 있는 Vercel 프로젝트를 사용하세요. Vercel 샌드박스 SDK의 인증 방식은 애플리케이션이 실행되는 환경에 따라 달라집니다.
- 로컬에서 실행하는 경우: 환경 변수
VERCEL_TOKEN,VERCEL_TEAM_ID,VERCEL_PROJECT_ID를 설정하세요. - Vercel에 배포한 경우: Vercel OIDC를 사용하세요.
애플리케이션에서 요청을 보낼 때는 OPENAI_API_KEY를 사용하세요. OPENAI_EXECUTOR_API_KEY의 값으로 환경 키를 설정하고, 샌드박스에는 이 키만 CODEX_API_KEY로 전달하세요.
1. Vercel 환경 설정하기
자체 호스팅 세션을 만들고 해당 세션의 환경 ID를 저장하세요. Vercel SDK 또는 API를 사용해 지정한 작업 디렉터리를 사용하는 격리된 샌드박스를 만드세요. 샌드박스에 Codex CLI를 설치한 다음, 앞서 저장한 환경 ID와 환경 키를 사용해 실행기를 시작하세요.
샌드박스를 자주 사용한다면 Vercel 스냅샷에 Codex를 포함하세요. 그러면 샌드박스 연결에 걸리는 시간을 줄일 수 있습니다.
2. 세션 실행하기
Vercel 실행기가 연결되면 세션 실행 및 이어가기의 HTTP 예제에 따라 입력을 보내고 결과를 스트리밍으로 받으세요. 작업을 마치면 세션을 삭제하고 Vercel 샌드박스도 별도로 중지하세요.