피드로 돌아가기
Spotify EngineeringAI/ML
원문 읽기
OpenAPI 기반 Markdown 플러그인으로 Spotify Ads API 복잡도 해결
Building a Natural Language Interface to the Spotify Ads API with Claude Code Plugins
AI 요약
Context
30개 이상의 리소스 타입과 다층 계층 구조를 가진 Spotify Ads API의 높은 인지 부하 문제 발생. 단순 API 호출을 넘어 캠페인-광고 세트-광고로 이어지는 복잡한 엔티티 생명주기 관리를 위한 오케스트레이션 비용 과다.
Technical Solution
- Markdown 기반 Skill 및 Agent 정의를 통한 컴파일 및 빌드 단계 제거로 개발 사이클 단축
- MCP(Model Context Protocol) 대신 온디맨드 문서 로딩 방식을 채택하여 LLM 컨텍스트 윈도우 낭비 방지
- PreToolUse Hook 레이어 설계를 통한 OAuth 토큰 갱신 및 HTTP 헤더 주입의 투명한 처리
- 모든 API 호출을 curl 명령어로 노출하여 실행 과정의 가시성 확보 및 디버깅 효율성 증대
- OpenAPI v3 스펙을 Single Source of Truth로 활용하여 API 정합성 유지 및 비즈니스 로직의 자연어 명세화
- Bash 스크립트와 Python 헬퍼를 활용한 최소 의존성 런타임 환경 구축
실천 포인트
1. LLM 도구 설계 시 모든 API 스펙을 컨텍스트에 넣지 말고 필요 시에만 로드하는 Dynamic Loading 구조 검토
2. 에이전트의 블랙박스 동작을 방지하기 위해 실행 단계의 원시 명령어(curl 등)를 사용자에게 노출하는 Audit Trail 설계
3. 인프라 의존성을 최소화하기 위해 설정 파일과 명세서를 Markdown/JSON 등 읽기 쉬운 형태로 관리