Agents SDK 알파, 기존 실행 흐름을 별도 경로로 불러온다

기존 실행 흐름과 새 실행 흐름을 구분합니다

Python Agents SDK 0.24.0-alpha.7은 한국시간 2026년 11월 8일 공개됐습니다. 기존 v0 런타임을 agents.classic 경로로 불러오고 새 네이티브 실행 방식과 함께 사용할 수 있다고 안내합니다. 같은 프로젝트에서 선택할 수 있다는 의미이지 두 방식의 객체와 체크포인트를 자유롭게 섞어도 된다는 뜻은 아닙니다.

릴리스는 Classic 통합을 위한 추가 의존성과 네이티브 실행의 구분을 명시합니다. 기존 코드를 가져오기 경로만 바꾸어 이전하는 것보다, 저장한 실행 상태와 도구·콜백이 어느 방식에 속하는지 먼저 확인해야 합니다. 이 글은 알파 버전의 특정 변경을 다루며 안정판 도입을 권하는 내용은 아닙니다.

새 환경의 쓰기 기본값이 바뀝니다

새 Environment의 write_policy 기본값은 strict입니다. 호환되는 Linux 또는 macOS 실행기가 필요하며, 작업 디렉터리는 쓰기 가능하고 추가 디렉터리는 writable_roots로 지정합니다. 기존 원격 정책을 유지하려는 경우에는 legacy를 명시하고 writable_roots를 None으로 두라는 이전 안내가 있습니다.

이는 기존 정책을 덜 엄격한 방식으로 바꾸라는 권장이 아닙니다. 저장된 환경의 정책과 새 환경의 기본값이 다를 수 있다는 설명입니다. 로컬 실행은 strict 모드가 필요하며, 과거 원격 상태를 다시 여는 것만으로 정책이 자동 업그레이드되지 않습니다.

저장한 대화는 파일과 실행 권한을 담지 않습니다

연결된 상태 저장 가이드는 대화 체크포인트가 작업 공간 파일, 살아 있는 프로세스, 임의의 메모리 상태를 복사하지 않는다고 설명합니다. 복원할 때에는 현재 앱의 도구·컨텍스트·제공자 설정이 필요합니다. 과거 대화 기록이 인증 정보나 권한을 부여하는 것도 아닙니다.

strict 환경의 복원에서는 작업 디렉터리와 적용된 쓰기 범위 등 정책을 맞춰야 합니다. 저장한 상태와 현재 환경의 선언이 다르면 실행 전에 거부될 수 있으므로, 정상적인 텍스트 질의 하나가 성공했다고 이전이 끝났다고 판단하기 어렵습니다.

결과가 불명확한 도구는 먼저 확인합니다

프로세스가 중단되기 직전에 도구가 외부 작업을 끝냈지만 결과 저장은 못 했을 수 있습니다. 가이드는 이런 호출을 자동으로 반복하지 말고 실제 결과를 확인해 기록과 맞추도록 설명합니다. 파일 생성이나 외부 전송이 있었다면 단순 재시도로 중복 부작용이 생길 수 있기 때문입니다.

시험할 때는 운영 작업 대신 고정된 입력과 임시 파일을 사용하고, 승인 대기·취소·복원 조건을 나누어 보세요. 이 절차는 문서에 근거한 제안이며 실제 알파 런타임을 실행한 결과는 아닙니다. 기존 상태를 보존하고 작은 흐름부터 비교하는 것이 변경 범위를 이해하는 데 도움이 됩니다.

출처

• Agents SDK alpha.7 공식 릴리스
• 릴리스가 연결한 상태 저장·실행 정책 가이드