본문으로 건너뛰기

© 2026 Molayo

Vercel헤드라인2026. 05. 02. 10:41

콘텐츠 협상을 통한 에이전트 친화적 페이지 구축

요약

웹 에이전트가 웹 페이지의 구조화된 텍스트 콘텐츠만 필요로 하는 상황에서, 불필요한 마크업(네비게이션 메뉴, 스타일시트 등)을 제거하여 효율성을 높이는 방법을 설명합니다. 이 문제를 해결하기 위해 '콘텐츠 협상(Content Negotiation)'이라는 표준 HTTP 메커니즘을 활용할 것을 제안합니다. 클라이언트가 `Accept` 헤더를 통해 선호하는 콘텐츠 형식(예: `text/markdown`)을 지정하면, 서버는 해당 형식에 맞춰 페이지의 순수한 텍스트 표현을 반환할 수 있습니다.

핵심 포인트

  • 웹 에이전트는 웹 페이지 전체 마크업 대신 구조화된 텍스트만 필요로 합니다.
  • 콘텐츠 협상(Content Negotiation)은 클라이언트가 `Accept` 헤더를 통해 원하는 콘텐츠 형식을 서버에 요청하는 표준 HTTP 메커니즘입니다.
  • 서버가 이 기능을 지원하면, 동일한 URL에서 브라우저용 HTML과 에이전트용 마크다운 같은 깔끔한 텍스트를 모두 제공할 수 있습니다.
  • 에이전트는 `Accept: text/markdown, text/html, */*`와 같이 선호하는 형식을 헤더에 명시하여 최적의 콘텐츠를 자동으로 받을 수 있습니다.

에이전트는 웹 페이지를 가져와 질문을 답변하고 코드를 작성하며 작업을 완료합니다. 에이전트가 페이지를 요청하면 브라우저가 얻는 모든 것을 받습니다. 이는 네비게이션 메뉴, 스타일시트, JavaScript 번들, 추적 스크립트 및 푸터 링크를 포함합니다. 그러나 에이전트는 페이지의 구조화된 텍스트만 필요로 합니다. 이러한 추가 마크업은 에이전트를 혼란스럽게 하고 컨텍스트 윈도우를 소모하며 모든 요청을 더 비쌉니다. 에이전트가 필요한 것은 브라우저별 마크업 없이 페이지의 텍스트 콘텐츠만 요청할 수 있는 방법입니다. 이 문제를 해결합니다. 이는 클라이언트가 헤더를 통해 선호하는 형식을 지정하고 서버가 일치하는 표현을 반환하는 표준 HTTP 메커니즘입니다. 많은 에이전트가 페이지를 가져올 때 이미 보냅니다. 콘텐츠를 협상하는 기능을 지원하는 서버는 브라우저에 HTML 을 제공하는 동일한 URL 에서 깔끔한 구조화된 텍스트를 반환할 수 있습니다.

콘텐츠 협상 (Content Negotiation)
Accept: text/markdown

우리는 블로그 및 변경 로그를 포함한 많은 페이지를 업데이트하여 콘텐츠 협상을 지원합니다. 이 게시물은 작동 방식, Next.js 에서 구현한 방법, 에이전트가 콘텐츠를 발견할 수 있도록 마크다운 사이트맵을 추가하는 방법을 설명합니다.

에이전트가 페이지를 가져올 때 형식 선호도를 포함하는 헤더를 포함합니다:
Accept: text/markdown, text/html, /

첫 번째로 나열함으로써 에이전트는 HTML 이 사용 가능한 경우에도 마크다운을 선호한다는 신호를 보냅니다. 이는 별도의 URL 을 호스팅하는 것보다 더 잘 작동하며 콘텐츠 협상은 사이트별 지식이 필요하지 않기 때문입니다. 올바른 헤더를 보내는 모든 에이전트는 지원되는 사이트에서 자동으로 마크다운을 받습니다.

text/markdown .md

직접 시도해 보세요:
curl https://vercel.com/blog/self-driving-infrastructure -H

AI 자동 생성 콘텐츠

본 콘텐츠는 Vercel AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
5

댓글

0