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

발표 내용

Python Agents SDK 0.24.0-alpha.7은 기존 워크플로를 agents.classic으로 불러와 새 실행 방식과 함께 사용할 수 있다고 안내했습니다. 실행기의 쓰기 관련 기본값도 변경됐습니다.

확인할 부분

알파 버전을 테스트할 때는 기존 프로젝트를 열기 전에 쓰기 동작과 권한이 어떻게 달라지는지 릴리스의 마이그레이션 항목을 보는 것이 좋습니다.

같은 작업을 두 실행 경로에 넣어 보기

알파를 평가할 때는 간단한 질의 하나가 성공하는지보다, 팀에서 이미 돌리는 작업 가운데 중간에 도구를 호출하고 결과를 다음 단계로 넘기는 사례를 골라 보는 편이 낫습니다. 예를 들어 주문 상태를 읽고 안내문을 만드는 흐름은 조회 결과, 도구 호출 순서, 마지막 응답이라는 세 관찰 지점이 있어요. 기존 경로와 새 경로에 같은 입력과 테스트용 응답을 주고 어느 지점부터 달라지는지 기록하면, 가져오기 경로를 바꾼 결과와 실행기의 동작 차이를 구분할 수 있어요.

쓰기 기본값이 달라지는 변경은 읽기 전용 실험과 따로 봅니다. 테스트용 파일이나 임시 저장소를 두고 실행 전후 차이를 비교합니다. 사용자의 확인을 기다리는 작업, 도구가 오류를 내는 작업, 중간에 취소하는 작업을 각각 넣으면 정상 응답만으로는 보이지 않는 차이가 드러납니다. 실패한 작업이 재시도될 때 쓰기가 중복되는지도 같은 실행 기록에서 볼 수 있어요.

마이그레이션을 작게 하려면 외부 시스템에 영향을 주는 흐름은 기존 경로에 둔 채, 먼저 입력과 결과를 쉽게 재현할 수 있는 흐름에서 확인하는 방법이 있어요. 두 실행을 같은 시점에 운영 데이터로 호출하면 조회 상태가 바뀌거나 부작용이 겹칠 수 있어요. 고정된 테스트 데이터에서 비교한 뒤, 기존 경로에서 어떤 기대를 유지해야 하는지 문서에 적어 두면 알파 버전에서 문제가 생겼을 때 어디로 돌아갈지 명확합니다.

출처

• 공식 발표 원문 · 이 글의 근거
• 공식 프로젝트 저장소 · 프로젝트 소개와 문서