콘텐츠

Stainless와의 작별: SDK 생성 도구 사용 경험과 교훈

스토리 · 라마인덱스 테크 · 2026.09.04

LlamaIndex가 SDK 생성 도구인 Stainless를 사용하며 얻은 경험과, Stainless가 Anthropic에 합류함에 따라 서비스를 종료하게 되어 이를 마이그레이션하는 과정에서의 교훈을 공유합니다. LlamaIndex는 개발자 경험(Developer Experience)을 위해 고품질의 idiomatic한 SDK가 필요했고, Stainless는 OpenAPI 명세서의 구조를 그대로 노출하는 대신 각 언어에 최적화된 인터페이스를 제공해 주었습니다. 또한, SDK 생성이 API 설계 자체의 품질을 높이는 데 도움을 주었다는 점도 언급합니다. 하지만 생성된 코드의 인터페이스 자체가 하나의 API 역할을 하기 때문에, 도구를 교체할 때 기존 사용자들의 인터페이스를 유지하는 것이 매우 중요하다는 마이그레이션의 핵심 교훈을 전달하고 있습니다.