문제 해결

지원 환경

OpenAI Agents SDK는 다음 서버 환경에서 지원됩니다:

Cloudflare Workers: Agents SDK는 Cloudflare Workers에서 사용할 수 있으나, 현재 몇 가지 제한이 있습니다:
- 현재 SDK는 nodejs_compat 활성화가 필요함
- 요청 종료 시 트레이스를 수동으로 flush해야 함. 자세한 내용은 트레이싱을 참고하세요
- Cloudflare Workers의 AsyncLocalStorage 제한적 지원으로 인해 일부 트레이스가 정확하지 않을 수 있음
- 아웃바운드 WebSocket 연결은 fetch 기반 업그레이드를 사용해야 함(글로벌 WebSocket 생성자 사용 불가). Realtime의 경우, @openai/agents-extensions의 Cloudflare transport(CloudflareRealtimeTransportLayer)를 사용하세요
브라우저:
- 브라우저에서는 현재 트레이싱이 지원되지 않음
v8 아이솔레이트:
- 올바른 브라우저 폴리필을 사용하는 번들러로 SDK를 v8 아이솔레이트용으로 번들링할 수 있지만, 트레이싱은 동작하지 않음
- v8 아이솔레이트는 광범위하게 테스트되지 않음

SDK 사용 중 문제가 발생한다면 디버그 로깅을 활성화하여 동작 정보를 더 자세히 확인할 수 있습니다.

DEBUG 환경 변수를 openai-agents:*로 설정하여 디버그 로깅을 활성화하세요.

DEBUG=openai-agents:*

또는 SDK의 특정 부분에만 범위를 한정하여 디버깅할 수 있습니다: