You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
このバージョンでは、デフォルトのハンドオフ履歴が raw な user/assistant のターンを露出するのではなく、単一の assistant メッセージにパッケージされるようになり、下流のエージェントに簡潔で予測可能な要約を提供します。
47
-
-既存の単一メッセージのハンドオフトランスクリプトは、デフォルトで `<CONVERSATION HISTORY>` ブロックの前に "For context, here is the conversation so far between the user and the previous agent:" で始まるようになりました。これにより、下流のエージェントは明確にラベル付けされた要約を受け取れます。
48
+
このバージョンでは、デフォルトのハンドオフ履歴が raw の user/assistant ターンを露出するのではなく、1 つの assistant メッセージにまとめられるようになり、後続のエージェントに対して簡潔で予測可能な要約を提供します。
49
+
-既存の 1 メッセージのハンドオフ文字起こしは、デフォルトで `<CONVERSATION HISTORY>` ブロックの前に "For context, here is the conversation so far between the user and the previous agent:" で始まるようになり、後続のエージェントが明確にラベル付けされた要約を受け取れるようになります。
Copy file name to clipboardExpand all lines: docs/ko/release.md
+21-19Lines changed: 21 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,66 +4,68 @@ search:
4
4
---
5
5
# 릴리스 프로세스/변경 로그
6
6
7
-
이 프로젝트는 `0.Y.Z` 형식을 사용하는, 약간 수정된 시맨틱 버저닝을 따릅니다. 앞의 `0`은 SDK가 아직 빠르게 진화하고 있음을 의미합니다. 구성 요소는 다음과 같이 증가합니다:
7
+
이 프로젝트는 `0.Y.Z` 형식을 사용하는, 약간 수정된 시맨틱 버저닝을 따릅니다. 앞의 `0`은 SDK가 아직 빠르게 발전 중임을 의미합니다. 구성 요소는 다음과 같이 증가합니다.
8
8
9
9
## 마이너(`Y`) 버전
10
10
11
-
베타로 표시되지 않은 모든 공개 인터페이스에 대한 **호환성을 깨는 변경(breaking changes)**이 있을 때 마이너 버전 `Y`를 올립니다. 예를 들어 `0.0.x`에서 `0.1.x`로 가는 경우 breaking changes가 포함될 수 있습니다.
11
+
베타로 표시되지 않은 모든 공개 인터페이스에 대한 **호환성이 깨지는 변경**이 있을 때 마이너 버전 `Y`를 올립니다. 예를 들어,`0.0.x`에서 `0.1.x`로 올라가면서 호환성이 깨지는 변경이 포함될 수 있습니다.
12
12
13
-
breaking changes를 원하지 않는다면, 프로젝트에서 `0.0.x` 버전에 고정(pin)하는 것을 권장합니다.
13
+
호환성이 깨지는 변경을 원하지 않는다면, 프로젝트에서 `0.0.x` 버전에 고정(pin)할 것을 권장합니다.
14
14
15
15
## 패치(`Z`) 버전
16
16
17
-
호환성을 깨지 않는 변경에 대해서는`Z`를 증가합니다:
17
+
호환성을 깨지 않는 변경에 대해`Z`를 올립니다:
18
18
19
19
- 버그 수정
20
-
-새로운 기능
20
+
-신규 기능
21
21
- 비공개 인터페이스 변경
22
22
- 베타 기능 업데이트
23
23
24
-
## breaking change 변경 로그
24
+
## 호환성이 깨지는 변경 로그
25
25
26
26
### 0.9.0
27
27
28
-
이 버전에서는 Python 3.9가 더 이상 지원되지 않습니다. 메이저 버전이 이미 3개월 전에 EOL되었기 때문입니다. 더 새로운 런타임 버전으로 업그레이드해 주세요.
28
+
이 버전부터 Python 3.9는 더 이상 지원되지 않습니다. 이 주요 버전은 3개월 전에 EOL에 도달했습니다. 더 최신의 런타임 버전으로 업그레이드해 주세요.
29
+
30
+
또한 `Agent#as_tool()` 메서드가 반환하는 값의 타입 힌트가 `Tool`에서 `FunctionTool`로 더 좁혀졌습니다. 이 변경은 보통 호환성을 깨는 문제를 일으키지 않지만, 코드가 더 넓은 유니온 타입에 의존한다면 일부 조정이 필요할 수 있습니다.
29
31
30
32
### 0.8.0
31
33
32
-
이 버전에서는 런타임 동작 변경 2가지로 인해 마이그레이션 작업이 필요할 수 있습니다:
34
+
이 버전에서는 런타임 동작 변경 두 가지로 인해 마이그레이션 작업이 필요할 수 있습니다:
33
35
34
-
-**동기식** Python callable을 래핑하는 함수 도구는 이제 이벤트 루프 스레드에서 실행하는 대신 `asyncio.to_thread(...)`를 통해 워커 스레드에서 실행됩니다. 도구 로직이 스레드 로컬 상태(thread-local state) 또는 스레드에 종속된 리소스(thread-affine resources)에 의존한다면, 비동기 도구 구현으로 마이그레이션하거나 도구 코드에서 스레드 종속성을 명시적으로 처리하세요.
35
-
- 로컬 MCP 도구 실패 처리 방식이 이제 설정 가능하며, 기본 동작은 전체 실행을 실패시키는 대신 모델이 볼 수 있는 오류 출력을 반환할 수 있습니다. fail-fast 의미론에 의존한다면 `mcp_config={"failure_error_function": None}`로 설정하세요. 서버 레벨의`failure_error_function`값은 에이전트 레벨 설정을 덮어쓰므로, 명시적 핸들러가 있는 각 로컬 MCP 서버에서`failure_error_function=None`을 설정하세요.
36
+
-**동기식** Python 호출 가능 객체를 래핑하는 함수 도구는 이제 이벤트 루프 스레드에서 실행되는 대신 `asyncio.to_thread(...)`를 통해 워커 스레드에서 실행됩니다. 도구 로직이 스레드 로컬 상태나 스레드 종속 리소스에 의존한다면, 비동기 도구 구현으로 마이그레이션하거나 도구 코드에서 스레드 종속성을 명시적으로 처리하세요.
37
+
- 로컬 MCP 도구 실패 처리 방식이 이제 구성 가능해졌고, 기본 동작은 전체 실행을 실패시키는 대신 모델에 보이는 오류 출력을 반환할 수 있습니다. fail-fast 시맨틱에 의존한다면 `mcp_config={"failure_error_function": None}`로 설정하세요. 서버 수준의`failure_error_function`값이 에이전트 수준 설정을 덮어쓰므로, 명시적 핸들러가 있는 각 로컬 MCP 서버에`failure_error_function=None`을 설정하세요.
36
38
37
39
### 0.7.0
38
40
39
-
이 버전에서는 기존 애플리케이션에 영향을 줄 수 있는 몇 가지 동작 변경이 있었습니다:
41
+
이 버전에는 기존 애플리케이션에 영향을 줄 수 있는 몇 가지 동작 변경이 있습니다:
40
42
41
-
- 중첩 핸드오프 기록(nested handoff history)은 이제 **옵트인**(기본 비활성화)입니다. v0.6.x의 기본 중첩 동작에 의존했다면 `RunConfig(nest_handoff_history=True)`를 명시적으로 설정하세요.
42
-
-`gpt-5.1` / `gpt-5.2`의 기본 `reasoning.effort`가 `"none"`으로 변경되었습니다(이전에는 SDK 기본값으로 `"low"`가 설정되어 있었음). 프롬프트나 품질/비용 프로파일이 `"low"`에 의존했다면 `model_settings`에서 이를 명시적으로 설정하세요.
43
+
- 중첩 핸드오프 히스토리는 이제 **옵트인**(기본 비활성화)입니다. v0.6.x의 기본 중첩 동작에 의존했다면 `RunConfig(nest_handoff_history=True)`를 명시적으로 설정하세요.
이 버전에서는 기본 핸드오프 기록이 원문 사용자/어시스턴트 턴을 노출하는 대신 하나의 assistant 메시지로 패키징되어, 다운스트림 에이전트에 간결하고 예측 가능한 요약을 제공합니다
47
-
- 기존의 단일 메시지 핸드오프 전사본은 이제 기본적으로 `<CONVERSATION HISTORY>` 블록 앞에 "For context, here is the conversation so far between the user and the previous agent:"로 시작하여, 다운스트림 에이전트가 명확히 라벨된 요약을 받을 수 있습니다
48
+
이 버전부터 기본 핸드오프 히스토리는 원문 사용자/어시스턴트 턴을 노출하는 대신 단일 어시스턴트 메시지로 패키징되어, 다운스트림 에이전트에 간결하고 예측 가능한 요약을 제공합니다
49
+
- 기존의 단일 메시지 핸드오프 트랜스크립트는 이제 기본적으로 `<CONVERSATION HISTORY>` 블록 앞에 "For context, here is the conversation so far between the user and the previous agent:"로 시작하여, 다운스트림 에이전트가 명확히 라벨된 요약을 받도록 합니다
48
50
49
51
### 0.5.0
50
52
51
-
이 버전은 눈에 띄는 breaking changes를 도입하지는 않지만, 새로운 기능과 내부적으로 몇 가지 중요한 업데이트를 포함합니다:
53
+
이 버전은 눈에 보이는 호환성 파괴 변경은 도입하지 않지만, 신규 기능과 내부적으로 중요한 몇 가지 업데이트를 포함합니다:
52
54
53
-
-[SIP protocol connections](https://platform.openai.com/docs/guides/realtime-sip)을 처리하기 위한 `RealtimeRunner` 지원 추가
55
+
-[SIP 프로토콜 연결](https://platform.openai.com/docs/guides/realtime-sip)을 처리하기 위한 `RealtimeRunner` 지원 추가
54
56
- Python 3.14 호환성을 위해 `Runner#run_sync`의 내부 로직을 대폭 개정
55
57
56
58
### 0.4.0
57
59
58
-
이 버전에서는[openai](https://pypi.org/project/openai/) 패키지 v1.x 버전이 더 이상 지원되지 않습니다. 이 SDK와 함께 openai v2.x를 사용하세요.
60
+
이 버전부터[openai](https://pypi.org/project/openai/) 패키지 v1.x 버전은 더 이상 지원되지 않습니다. 이 SDK와 함께 openai v2.x를 사용해 주세요.
59
61
60
62
### 0.3.0
61
63
62
64
이 버전에서는 Realtime API 지원이 gpt-realtime 모델 및 해당 API 인터페이스(GA 버전)로 마이그레이션됩니다.
63
65
64
66
### 0.2.0
65
67
66
-
이 버전에서는 과거에 `Agent`를 인자로 받던 몇몇 위치가 이제 `AgentBase`를 인자로 받도록 변경되었습니다. 예를 들어 MCP 서버의 `list_tools()`호출이 그렇습니다. 이는 순수하게 타이핑 변경이며, 여전히 `Agent` 객체를 받게 됩니다. 업데이트하려면 `Agent`를 `AgentBase`로 바꿔 타입 오류를 수정하기만 하면 됩니다.
68
+
이 버전에서는 이전에 인자로 `Agent`를 받던 몇몇 위치가 이제 `AgentBase`를 인자로 받습니다. 예를 들어 MCP 서버의 `list_tools()`호출입니다. 이는 순수하게 타이핑 변경이며, 여전히 `Agent` 객체를 받게 됩니다. 업데이트하려면 `Agent`를 `AgentBase`로 바꾸어 타입 오류만 수정하면 됩니다.
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4&size=40){kind=avatar}
0 commit comments