콘텐츠로 이동

릴리스 프로세스/변경 로그

이 프로젝트는 0.Y.Z 형식의 의미적 버전 관리(semantic versioning)를 약간 수정한 방식을 따릅니다. 선행하는 0은 SDK 가 여전히 빠르게 발전 중임을 나타냅니다. 구성 요소 증분 규칙은 다음과 같습니다:

마이너(Y) 버전

베타로 표시되지 않은 공개 인터페이스에 호환성 파괴 변경 사항이 있을 때 마이너 버전 Y를 증가시킵니다. 예를 들어, 0.0.x에서 0.1.x로 올라갈 때 호환성 파괴 변경 사항이 포함될 수 있습니다.

호환성 파괴 변경을 원하지 않으시면, 프로젝트에서 0.0.x 버전에 고정할 것을 권장합니다.

패치(Z) 버전

호환성을 깨지 않는 변경에 대해 Z를 증가시킵니다:

  • 버그 수정
  • 새로운 기능
  • 비공개 인터페이스 변경
  • 베타 기능 업데이트

호환성 파괴 변경 사항 로그

0.6.0

이 버전에서는 기본 핸드오프 히스토리가 원문 사용자/assistant 턴을 노출하는 대신 단일 assistant 메시지로 패키징되어, 다운스트림 에이전트가 간결하고 예측 가능한 요약을 받을 수 있습니다 - 기존의 단일 메시지 핸드오프 대화록은 이제 기본적으로 <CONVERSATION HISTORY> 블록 앞에 "For context, here is the conversation so far between the user and the previous agent:"로 시작하여, 다운스트림 에이전트가 명확하게 라벨링된 요약을 받도록 합니다

0.5.0

이 버전은 눈에 보이는 호환성 파괴 변경을 도입하지는 않지만, 새로운 기능과 몇 가지 중요한 내부 업데이트를 포함합니다:

  • RealtimeRunner가 SIP 프로토콜 연결을 처리하도록 지원을 추가했습니다
  • Python 3.14 호환성을 위해 Runner#run_sync의 내부 로직을 대폭 개정했습니다

0.4.0

이 버전부터는 openai 패키지 v1.x 버전을 더 이상 지원하지 않습니다. 이 SDK와 함께 openai v2.x 를 사용해 주세요.

0.3.0

이 버전에서는 Realtime API 지원이 gpt-realtime 모델과 해당 API 인터페이스(GA 버전)로 마이그레이션됩니다.

0.2.0

이 버전에서는 몇몇 위치에서 인자로 Agent를 받던 것을 이제 AgentBase를 인자로 받도록 변경했습니다. 예: MCP 서버의 list_tools() 호출. 이는 순수하게 타입 관련 변경이며, 여전히 Agent 객체를 받게 됩니다. 업데이트하려면, Agent를 AgentBase로 교체하여 타입 오류만 수정하시면 됩니다.

0.1.0

이 버전에서는 MCPServer.list_tools()에 run_context와 agent 두 개의 새로운 매개변수가 추가되었습니다. MCPServer를 상속하는 모든 클래스에 이 매개변수를 추가해야 합니다.