API 및 SDK 폐기 정책
API 및 SDK 폐기 정책
LangSmith가 클라우드 및 셀프 호스팅 배포에서 API 엔드포인트와 SDK 메서드를 어떻게 폐기하고 제거하는지에 대한 문서예요.
LangSmith는 API 엔드포인트와 SDK 메서드를 제거하기 전에 폐기해서 대체 방법으로 마이그레이션할 시간을 줘요. 이 페이지는 폐기가 어떻게 발표되는지와 얼마나 오래 지원되는지 설명해요.
이 정책은 LangSmith API 참조와 Agent Server API 참조에 문서화된 공개 엔드포인트에만 적용돼요. 내부의 문서화되지 않은 엔드포인트는 적용 대상이 아니며, 호환되지 않는 변경을 포함해 언제든 변경될 수 있어요.
출처: 문서
본문
폐기 수명 주기
모든 폐기는 동일한 단계를 따르며 진행돼요:
- 발표 (Announced): 폐기가 변경 로그에 제거 날짜(알려질 경우)와 함께 게시되고, 호출 위치 변경이 필요할 경우 대체 방법을 문서화한 마이그레이션 가이드에도 게시돼요.
- 표시 (Marked): 폐기된 API 엔드포인트는
Deprecation: true및Sunset: <date>응답 헤더를 반환해요. 폐기된 SDK 메서드는 문서에 표시되고, 지원되는 경우 호출 시 폐기 경고를 발생시켜요. - 지원 (Supported): 폐기된 엔드포인트는 배포 유형에 따라 달라지는 최소 기간 동안 계속 작동해요. 배포별 폐기 기간을 참고하세요.
- 제거 (Removed): 지원 기간이 끝나면 엔드포인트가 제거돼요.
Cloud에서는 제거 날짜가 가까워도 활성 소비자가 남아 있으면, LangSmith는 폐기된 엔드포인트에 속도 제한과 지연 시간 증가를 적용하고, 요청의 일부에 명시적 오류 메시지를 반환해 제거 전에 남은 사용량의 주의를 끌 수 있어요. 영향을 받는 고객에게는 사전에 직접 연락해요.
배포별 폐기 기간
| 배포 | 최소 지원 기간 |
|---|---|
| Cloud | 발표부터 제거까지 6개월 |
| Self-hosted | 최소 한 개의 메이저 릴리스 |
셀프 호스팅 메이저 릴리스는 대략 6주 주기로 출시돼요. 자세한 내용은 릴리스 정책을 참고하세요.
SDK 메서드 폐기
대부분의 SDK 메서드는 API 엔드포인트의 얇은 래퍼이므로, 메서드는 호출하는 엔드포인트와 같은 타임라인으로 폐기되고 엔드포인트가 제거될 때 SDK에서 제거돼요.
엔드포인트와 일대일 대응하지 않는 메서드나 엔드포인트 변경과 무관하게 독립적으로 폐기되는 메서드는 다른 폐기 타임라인을 가질 수 있어요. 이는 SDK(문서와 폐기 경고를 통해)와 API(위에서 설명한 프로세스를 통해) 두 곳에서 명시적으로 발표돼요.
필드 수준 폐기
폐기된 필드는 날짜가 아닌 버전 경계에서 제거돼요:
- API 필드 및 파라미터: 폐기된 응답 필드, 요청 본문 필드 또는 쿼리 파라미터는 동일한 엔드포인트 버전 내에서 계속 작동해요. 제거는 호환되지 않는 변경이므로 다음 엔드포인트 버전(예: v1에서 v2)에서만 출시돼요.
- SDK 메서드 필드 및 파라미터: 현재 메이저 SDK 버전 내에서 계속 작동해요. 제거하려면 API 자체의 버전 관리와 무관하게 새 메이저 SDK 버전이 필요해요.