LAPIS: Lightweight API Specification for Intelligent Systems
이 논문은 LLM 의 토큰 소비를 크게 줄이면서도 API 추론에 필요한 의미 정보를 보존하기 위해 OpenAPI 를 기반으로 한 LAPIS(Lightweight API Specification for Intelligent Systems) 라는 새로운 경량 API 명세 형식을 제안하고, 실제 생산 환경의 API 스펙을 통해 OpenAPI 대비 평균 85.5% 의 토큰 감소 효과를 입증했습니다.
원본 논문은 CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/) 라이선스로 제공됩니다. 이것은 아래 논문에 대한 AI 생성 설명입니다. 저자가 작성하거나 승인한 것이 아닙니다. 기술적 정확성을 위해서는 원본 논문을 참조하세요. 전체 면책 조항 읽기
📝 LAPIS: AI 를 위한 '간결한 API 설명서'
이 논문은 **"인공지능 (LLM) 이 API(소프트웨어가 서로 대화하는 규칙) 를 이해할 때, 기존 설명서가 너무 길고 지저분해서 비효율적이다"**라는 문제에서 출발합니다.
저자는 이 문제를 해결하기 위해 LAPIS라는 새로운 형식을 제안했습니다. 이를 쉽게 이해할 수 있도록 일상적인 비유로 설명해 드릴게요.
1. 문제: "너무 두꺼운 백과사전" (기존 OpenAPI)
지금까지 개발자들이 API 를 설명할 때 쓰는 OpenAPI라는 표준은, 인간 개발자나 자동화 도구를 위해 만들어졌습니다.
- 비유: imagine 하세요. 식당에 메뉴를 주문하러 갔는데, 요리사가 **"이 요리는 2010 년부터 쓰인 레시피이며, 소금 3g, 후추 1.5g, 오븐 180 도에서 20 분, 그리고 이 그릇은 2015 년에 인증받은 것"**처럼 너무 상세하고 반복적인 정보를 종이에 적어주었다고 상상해 보세요.
- 문제점: 인간 요리사 (개발자) 는 이걸 보고 "아, 이걸로 요리할 수 있구나"라고 이해하지만, **AI(로봇 요리사)**는 이 불필요한 정보 때문에 머리 (메모리) 가 꽉 차고, 돈을 더 많이 내야 합니다.
- 같은 실수 (예: "음식이 없으면 404 에러") 를 메뉴 1,000 개마다 반복해서 적어놓는 식입니다.
- AI 가 진짜 필요한 건 "무엇을 주문하면 무엇이 나오는지"인데, 불필요한 저작권 정보나 연락처 같은 잡다한 내용까지 다 포함하고 있습니다.
2. 해결책: "요리사용 요약 카드" (LAPIS)
이 논문은 AI 를 위해 **불필요한 잡담을 다 빼고, 핵심만 담은 'LAPIS'**라는 새로운 형식을 만들었습니다.
- 비유: 이제 식당은 AI 로봇에게 **"이 요리는 고기 + 소스 = 스테이크, 404 에러는 '재료 없음'일 때만 발생"**이라고 한 장의 요약 카드로만 알려줍니다.
- 핵심 특징:
- 반복 제거: "재료 없음 (404 에러)"이라는 설명을 1,000 번 반복하지 않고, 맨 뒤에 한 번만 적어둡니다.
- 직관적인 문법: 복잡한 코드 대신, 사람이 화이트보드에 그릴 때 쓰는 **"화살표 (->)"**나 **"간단한 문장"**을 사용합니다.
- 새로운 정보 추가: 기존 설명서에 없던 **"주문 순서"**나 "할인 쿠폰 사용 조건" 같은 AI 가 알아야 할 실용적인 정보도 추가합니다.
3. 놀라운 결과: "90% 의 공간 절약"
논문의 실험 결과, GitHub나 Twilio 같은 거대한 서비스의 API 설명서를 LAPIS 로 바꾸면 다음과 같은 일이 일어났습니다.
- 토큰 (정보의 단위) 양: 기존 설명서의 약 85% 가 사라졌습니다.
- 비유: 두꺼운 백과사전 1 권 분량의 정보를, 포켓북 1 권으로 줄인 것과 같습니다.
- 비용 절감: AI 가 이 정보를 읽을 때 드는 비용이 약 5 배 이상 줄어듭니다.
- 만약 매일 1,000 번 AI 에게 API 를 물어본다면, 매달 수천 달러 (약 수백만 원) 를 아낄 수 있습니다.
4. 왜 중요한가요? (핵심 통찰)
이 논문의 가장 중요한 메시지는 **"압축 (Zip 파일) 만으로는 부족하다"**는 것입니다.
- 기존 방식 (TOON 등): 긴 문서를 단순히 글자 수만 줄이는 '압축'을 했습니다. 하지만 내용 자체는 여전히 중복되고 지저분합니다.
- LAPIS 방식: 내용 자체를 재구성했습니다. AI 가 이해하는 방식에 맞춰 구조를 바꾼 것입니다.
- 비유: 짐을 싸는 방식이 아니라, 짐을 싣는 트럭 자체를 AI 가 타고 다니기 편하게 개조한 것과 같습니다.
5. 결론: AI 시대를 위한 새로운 표준
LAPIS 는 기존 OpenAPI 를 완전히 없애는 것이 아니라, **AI 가 읽을 때만 변환해서 쓰는 'AI 전용 버전'**입니다.
- 개발자: 여전히 OpenAPI 로 상세한 문서와 코드를 만듭니다.
- AI: LAPIS 로 변환된 간결한 설명서를 받아서 빠르고 정확하게 작업을 합니다.
한 줄 요약:
"AI 가 API 를 이해할 때, 불필요한 잡담을 끊고 핵심만 전달하는 '요약본'을 주면, AI 는 더 똑똑해지고 우리는 돈을 아낄 수 있다"는 것을 증명했습니다.
이 기술은 앞으로 AI 가 더 복잡하고 다양한 서비스와 대화할 때, 속도와 비용을 획기적으로 개선할 열쇠가 될 것입니다.
연구 분야의 논문에 파묻히고 계신가요?
연구 키워드에 맞는 최신 논문의 일일 다이제스트를 받아보세요 — 기술 요약 포함, 당신의 언어로.