문제 해결
지원되는 환경
섹션 제목: “지원되는 환경”OpenAI Agents SDK는 다음 서버 환경에서 지원됩니다:
- Node.js 22+
- Deno 2.35+
- Bun 1.2.5+
제한적 지원
섹션 제목: “제한적 지원”- Cloudflare Workers: Agents SDK는 Cloudflare Workers에서 사용할 수 있지만, 현재 다음과 같은 제한이 있습니다:
- SDK는 현재
nodejs_compat
활성화가 필요함 - 요청 종료 시 트레이스를 수동으로 flush해야 함. 자세한 내용은 트레이싱을 참조하세요
- Cloudflare Workers의
AsyncLocalStorage
제한적 지원으로 인해 일부 트레이스가 정확하지 않을 수 있음 - 아웃바운드 WebSocket 연결은 전역
WebSocket
생성자가 아닌 fetch 기반 업그레이드를 사용해야 함. Realtime의 경우@openai/agents-extensions
의 Cloudflare 전송(CloudflareRealtimeTransportLayer
)을 사용하세요
- SDK는 현재
- 브라우저:
- 브라우저에서는 현재 트레이싱이 지원되지 않음
- v8 isolates:
- 적절한 브라우저 폴리필이 포함된 번들러를 사용하면 v8 isolates용으로 SDK를 번들링할 수 있지만, 트레이싱은 동작하지 않음
- v8 isolates는 광범위하게 테스트되지 않음
디버그 로깅
섹션 제목: “디버그 로깅”SDK 사용 중 문제가 발생하면 디버그 로깅을 활성화하여 동작 상황에 대한 추가 정보를 얻을 수 있습니다.
DEBUG
환경 변수를 openai-agents:*
로 설정하여 디버그 로깅을 활성화하세요.
DEBUG=openai-agents:*
또는 SDK의 특정 부분에 대해서만 디버깅 범위를 지정할 수 있습니다:
openai-agents:core
— SDK의 주요 실행 로직openai-agents:openai
— OpenAI API 호출openai-agents:realtime
— Realtime Agents 구성요소