OpenAI Cookbook에서 애플리케이션 관리 방식과 웹훅 관리 방식의 예제를 확인하세요.
실행기 설정 방법과 연결 요건은 자체 호스팅 샌드박스를 참고하세요.
프로비저닝 방식을 선택하세요.
- 애플리케이션 관리 방식: 이 가이드에 따라 애플리케이션에서 샌드박스를 시작하고 중지하세요.
- 웹훅 관리 방식: OpenAI 웹훅을 받으면 샌드박스를 시작하거나 다시 연결하는 핸들러를 배포하세요.
두 방식의 차이는 샌드박스 수명 주기를 참고하세요.
시작하기 전에
OpenAI 프로젝트 API 키, Blaxel API 키와 워크스페이스, Codex CLI 패키지가 필요합니다.
BL_API_KEY와 BL_WORKSPACE를 설정하고 애플리케이션 요청에는 OPENAI_API_KEY를 사용하세요. OPENAI_EXECUTOR_API_KEY를 환경 키로 설정하고, 샌드박스에는 이 키만 CODEX_API_KEY로 전달하세요.
프로비저닝 코드에서 샌드박스 리전을 선택하세요. 아래에서 설명하는 Agent Drive로 파일을 보존하려면 us-was-1을 사용하세요.
1. Blaxel 환경 설정하기
자체 호스팅 세션을 만들고 해당 세션의 환경 ID를 저장하세요. Blaxel SDK 또는 API를 사용해 지정한 작업 디렉터리가 있는 격리된 샌드박스를 만드세요. 샌드박스에 Codex CLI를 설치한 다음, 앞에서 저장한 환경 ID와 환경 키를 사용해 실행기를 시작하세요.
Blaxel의 Node 이미지는 Alpine Linux를 사용하므로 ripgrep을 apk로 설치하세요. 환경 키는 CODEX_API_KEY로 실행기 프로세스에만 전달하세요. keep_alive=True를 설정하면 실행기가 동작하는 동안 샌드박스 인스턴스 수가 0으로 줄어들지 않습니다. 설정 작업, 실행기, 샌드박스에 각각 시간 제한을 두면 방치된 리소스가 무기한 실행되는 것을 막을 수 있습니다.
샌드박스를 자주 사용한다면 Codex와 ripgrep이 미리 설치된 Blaxel 이미지를 빌드하세요. 그러면 샌드박스가 더 빨리 연결됩니다.
2. 세션 실행하기
Blaxel 실행기가 연결되면 세션 실행 및 이어가기의 HTTP 예제를 사용해 입력을 보내고 결과를 스트리밍하세요. 작업을 마치면 세션을 삭제하고 공급자의 샌드박스도 별도로 중지하세요.
입력을 보내기 전에 샌드박스를 시작하세요. 턴은 환경이 연결될 때까지 대기합니다. 환경이 연결되면 세션은 이벤트 스트림에 agent.session.environment.connected 이벤트를 보냅니다.
턴이 성공적으로 완료되었는지는 agent.session.turn.completed 이벤트로 확인하세요. 턴이 실패하거나 취소된 뒤에도 agent.session.idle 이벤트가 발생할 수 있으므로 세션이 유휴 상태라는 이유만으로 턴이 성공했다고 판단하지 마세요.
선택 사항: 세션 간 파일 보존하기
Blaxel Agent Drive를 사용하면 샌드박스와 세션이 바뀌어도 파일을 보존할 수 있습니다. 파일을 공유하려면 각 샌드박스에 같은 드라이브를 마운트하세요. Agent Drive를 사용하려면 us-was-1 리전이 필요하며, 대화 기록이나 세션 상태는 전송되지 않습니다.