openai-agents 0.13.2의 openai v2 강제 전환에 따른 API Breaking Change 분석

Context

openai-agents 0.13.2 버전에서 하위 호환성을 유지하던 openai v1 지원을 전격 중단함. PyPI 메타데이터 변경을 통해 openai >=2.26.0 요구사항을 강제하며 기존 v1 기반 클라이언트 코드와의 충돌 유발함.

Technical Solution

• 모듈 수준의 전역 상태 기반 호출에서 명시적 Client 인스턴스 생성 기반 구조로 전환
• openai.ChatCompletion.create()의 정적 메서드 호출 방식을 client.chat.completions.create()의 인스턴스 메서드 구조로 변경
• openai.api_key 전역 설정 방식을 OpenAI() 클래스 생성자 통한 API Key 주입 방식으로 변경
• Embedding 생성 로직을 전역 함수 호출에서 client.embeddings.create() 구조로 변경하여 일관성 확보
• Agent framework API와 하부 HTTP Client 계층을 분리하여 프레임워크 내부 로직의 안정성 유지