HTML에 LLM 지시문 내장하기: llms.txt 인라인 제안

AI 에이전트가 인증 페이지 등 보호된 리소스를 만났을 때 어떻게 대처해야 할지 안내하는 새 HTML 컨벤션을 제안한다. 브라우저가 무시하는 알 수 없는 스크립트 타입을 활용해 `<script type="text/llms.txt">` 블록 안에 LLM 전용 지시문을 삽입하는 방식이다.

핵심 포인트

핵심 아이디어: `<script type="text/llms.txt">` 태그 — 브라우저는 미지원 타입을 무시하지만 LLM은 내용을 읽음.
왜 script 태그인가: `<head>` 안에 위치 가능, AI 시스템이 먼저 스캔하는 영역, 임의 콘텐츠(마크다운 포함) 수용.
llms.txt 표준 확장: 기존 llms.txt(별도 파일)에 "에피메럴 발견" 기능 추가 — 페이지 안에 내장되어 사전 설정 없이 자동 발견.
Vercel 실제 적용: 401 인증 오류 페이지에 적용 — 에이전트를 MCP 서버로 안내, 사람 사용자는 토큰 발급 문서로 안내.
벤더 조정 불필요: LLM의 유연한 텍스트 해석 능력 덕분에 표준화 없이도 즉시 채택 가능.

상세 정리

기술 스펙: `<script type="text/llms.txt">` 태그에 마크다운 형식 지시문 작성. 브라우저 렌더링에 영향 없음.
발견 메커니즘: 에이전트가 URL 접근 시 HTML을 파싱하고 head 스캔 — 별도 .txt 파일 없이도 컨텍스트별 지시문 발견 가능.
llms.txt와의 관계: llms.txt는 도메인 수준 AI 안내 파일. 인라인 버전은 페이지별 에이전트 행동 지정 — 더 세분화된 제어.
활용 시나리오: 인증 실패 페이지(에이전트를 인증 흐름으로), 유료 콘텐츠 페이지(대안 접근법 안내), API 게이트웨이 오류 페이지(프로그래밍 방식 접근 방향 제시).
Vercel 구현 예시: 401 페이지에서 에이전트는 MCP 서버 URL과 인증 방법을 지시문으로 받고, 사람 사용자는 일반 오류 UI를 보는 이중 경험.

왜 읽나AI 에이전트가 보호된 웹 리소스를 만났을 때의 처리를 개선하려는 웹 개발자·AI 인프라 엔지니어에게 즉시 구현 가능한 경량 컨벤션 소개.

Vercel Blog 블로그

원문은 여기서 이어서 읽을 수 있어요

원문 읽기

읽음 (0)

·takedown 요청