AI BriefingContent Negotiation을 활용한 에이전트 친화적 페이지 구축
·2026.02.03 22:00
핵심 내용
Content Negotiation을 통해 AI 에이전트에게 최적화된 Markdown을 제공함으로써 토큰 효율성을 극대화한다.
자세히 보기
AI 에이전트가 웹 페이지를 수집할 때 브라우저용 HTML, CSS, JavaScript, 트래킹 스크립트 등 불필요한 마크업까지 모두 가져오는 문제가 있다. 이는 에이전트의 **컨텍스트 윈도우(Context Window)**를 낭비하고 요청 비용을 높이는 원인이 된다.
Content Negotiation을 활용하면 클라이언트가 Accept 헤더를 통해 선호하는 형식을 지정하고, 서버는 이에 맞춰 최적화된 데이터를 반환할 수 있다. 에이전트가 Accept: text/markdown을 요청하면, 서버는 동일한 URL에서 브라우저용 HTML 대신 구조화된 Markdown을 제공한다.
Vercel은 Next.js를 사용하여 이를 구현했다. next.config.ts의 rewrite 규칙으로 헤더를 감지하고, Route Handler를 통해 CMS의 리치 텍스트를 실시간으로 Markdown으로 변환하여 반환한다. 이때 Next.js 16 remote cache를 사용하여 HTML과 Markdown 버전의 동기화를 유지한다.
이 방식의 주요 이점은 다음과 같다:
- 페이로드 최적화: HTML 버전(약 500KB) 대비 Markdown 버전(3KB)은 약 **99.37%**의 크기 감소를 달성하여 토큰 효율성을 극대화한다.
- Markdown Sitemap: 기존 XML 사이트맵과 달리, 계층 구조와 제목이 포함된 Markdown 사이트맵을 제공하여 에이전트가 사이트 구조를 더 쉽게 이해하도록 돕는다.
- 발견 가능성:
Accept헤더를 사용하지 않는 에이전트를 위해 HTML<head>에<link rel="alternate">태그를 추가하여 Markdown 경로를 안내한다.
이 한국어 요약은 AI가 자동으로 만들었습니다. 원문의 주장과 맥락은 원문에서 확인해 주세요. 저작권은 원저작자에게 있습니다.