toon-format은(는) 무엇을 하나요?
토큰 지향 객체 표기법(TOON)에 대한 전문 기술 — LLM 프롬프트용 스키마 인식 간결 JSON 인코딩으로 토큰을 약 40% 절감합니다.
개요
TOON은 JSON의 대안으로, 필드 이름을 짧은 식별자로 압축하고 스키마를 사용하여 구조적 중복을 제거합니다. 이는 특히 반복적인 구조가 많은 LLM 프롬프트에서 효과적입니다.
시작하기
TOON을 사용하려면 스키마를 정의한 다음 데이터를 인코딩하면 됩니다.
const schema = {
user: { id: 'int', name: 'str', role: 'str' }
};
const data = {
user: { id: 1, name: "Alice", role: "admin" }
};
const encoded = toonEncode(data, schema);
// 결과: "u.id=1,u.name=Alice,u.role=admin"
지원 기능
- 스키마 기반 인코딩: 필드 이름을 짧은 별칭으로 압축
- 중첩 객체: 점 표기법을 사용한 계층적 구조 지원
- 배열: 쉼표로 구분된 배열 요소 인코딩
- 기본 타입:
int,float,str,bool,null지원 - 사용자 정의 스키마: 특정 사용 사례에 맞게 스키마 구성 가능
고급 사용법
조건부 필드
스키마에 조건부 필드를 정의할 수 있습니다:
schema:
entity:
type: str
id: int
metadata:
createdAt: str
updatedAt: optional str
벤치마크
TOON은 동일한 데이터에 대해 JSON보다 약 40% 적은 토큰을 사용합니다. 예:
| 포맷 | 예시 크기 (토큰) |
|---|---|
| JSON | 100 |
| TOON | 60 |
플랫폼 지원
TOON은 모든 주요 AI 에이전트 플랫폼(Claude Code, Cursor, Codex 등)과 호환되며, JavaScript/TypeScript, Python, Go용 인코더/디코더 라이브러리와 함께 사용할 수 있습니다.
참고 자료
- 전체 문서는 TOON 사양을 참조하세요.
- 예제 및 도구는 GitHub 리포지토리에서 확인하세요.