Anthropic Python SDK 2.6, 제한과 키 검증 오류 구분
모아보기 · 소식 기준일 · 블로그 공개
요청 한도와 외부 키 검증 실패에 관한 오류 코드를 추가했습니다.
발표 내용
2.6.0은 사용량 확대 한도 관련 오류와 외부 키 검증 실패 오류 코드를 추가했습니다. 조직 구성원을 모든 세션에서 로그아웃시키는 기능 지원도 포함됩니다.
확인할 부분
실패를 같은 오류로 묶어 처리하던 앱이라면 한도 관련 실패와 키 검증 실패를 다르게 안내할 수 있는지 확인할 만합니다.
사용량 문제와 키 문제는 대응이 달라요
한 요청이 실패했다는 사실만 보고 같은 정책으로 재시도하면, 잠시 기다려야 하는 제한과 설정을 수정해야 하는 실패가 섞입니다. 호출을 묶어 처리하는 서비스라면 사용량 한도 문제가 발생한 작업을 다시 대기열에 두는 동안, 외부 키 검증에 실패한 작업은 운영자가 설정을 확인할 수 있도록 별도 상태에 남기는 편이 이해하기 쉽습니다. 오류가 구분된다고 해서 두 경우 모두 자동 복구할 수 있다는 뜻은 아닙니다. 호출자가 대응을 달리할 수 있는 정보가 늘어난 것입니다.
확인할 예시는 호출 성공, 한도 오류, 키 검증 오류 세 가지입니다. 응답을 흉내 내는 테스트 서버에서 같은 업무를 실행하고, 화면에 보이는 안내와 운영 기록이 달라지는지 봅니다. 사용자에게는 다시 시도할 수 있는지 알려주되 키 값은 로그에 남기지 않습니다. 운영자에게 필요한 것은 오류 유형과 영향을 받은 작업, 최근 설정 변경을 찾는 데 쓰는 식별자입니다. 기존 SDK에서 내려오던 일반 오류에도 별도 경로를 유지해야 예상하지 못한 실패를 정상으로 기록하지 않습니다.
조직 구성원의 세션을 끊는 기능은 오류 분류와 별개의 관리 작업입니다. 사용자가 화면에서 로그아웃하는 경우와 관리자가 여러 세션을 끊는 경우를 같은 시나리오로 처리하면, 특정 기기에서만 상태가 바뀌는 문제를 놓칠 수 있어요. 관리 동작을 도입한다면 테스트용 구성원으로 여러 세션을 만든 뒤, 기존 세션에서 다시 요청할 때 어떤 응답이 오는지 확인할 만합니다.