Runloop

Runloop

이 가이드는 OpenAI Cookbook의 애플리케이션 관리형 예시를 참고해요.

출처: 문서

본문

이 가이드는 애플리케이션 관리형(application-managed) 프로비저닝을 사용해요. 애플리케이션이 Devbox를 시작하고, 실행기를 연결하고, 작업이 끝나면 종료해요. 수명주기 동작은 Sandbox lifecycle을 참고하세요.

시작하기 전에 (Before you begin)

Runloop SDK나 API로 Devbox를 관리하고, HTTP 요청으로 Agents API 세션을 관리하세요.

RUNLOOP_API_KEY를 설정하고 애플리케이션 요청에는 OPENAI_API_KEY를 사용하세요. OPENAI_EXECUTOR_API_KEY는 환경 키로 설정하고, 그 키만 CODEX_API_KEY로 Devbox에 전달하세요.

애플리케이션 관리형 (Application-managed)

  1. 자체 호스팅 세션 만들기를 하고 환경 ID를 저장하세요.
  2. 세션의 작업 디렉터리로 Runloop Devbox를 만들고 그 안에 Codex CLI를 설치하세요.
  3. 환경 ID와 환경 키로 실행기를 백그라운드에서 시작하세요.
  4. 입력을 보내고 결과를 확인하세요. 파일 과제라면 워크스페이스에 brief.txt를 만들고 에이전트에게 plan.md에 마이그레이션 계획을 쓰라고 하세요.
  5. 턴이 완료됐는지 확인하고, 필요한 파일을 검색한 뒤 Devbox를 종료하고 세션을 삭제하세요.

발생할 수 있는 일에 대비해 제한된 설정·실행 타임아웃과 Devbox 수명 제한을 폴백으로 사용하세요. 후속 턴이 필요하면 세션과 Devbox를 유지하세요. 세션마다 프로비저닝 소유자를 하나만 두고, 애플리케이션이 직접 관리하는 세션에는 프로비저닝 웹훅 핸들러를 연결하지 마세요.

참고 자료 (References)

더 알아보기 (Learn more)