llms.txt 파일 만드는 법
게시일: · 수정일:
llms.txt 파일은 작성하는 데 약 10분이면 충분합니다. 이 가이드는 각 구성 요소를 순서대로 짚어 가며, 마지막에는 그대로 붙여넣어 응용할 수 있는 파일로 마무리합니다.
1. H1 제목으로 시작하기
첫 줄은 반드시 단일 H1 — 프로젝트 또는 사이트의 이름 — 이어야 합니다. 이것은 이 형식에서 유일하게 엄격히 필수인 요소입니다.
# Acme Docs
2. 인용 블록 요약 추가하기
제목 바로 아래에 한두 문장의 인용 블록(blockquote)을 추가하세요. 이는 언어 모델이 가장 먼저 읽는 맥락이므로, 사이트가 무엇이며 누구를 위한 것인지 구체적으로 작성하세요.
> Acme is a payments API. This file links to the docs an LLM needs to integrate and debug Acme.
3. (선택) 짧은 설명 문단 추가하기
섹션 제목이 나오기 전에 추가적인 안내를 담은 일반 문단을 넣을 수 있습니다. 여기서는 제목을 사용하지 말고 한두 문장으로 간결하게 유지하세요.
4. H2 섹션 아래에 링크 묶기
각 섹션은 H2 제목과 그 뒤에 이어지는 마크다운 목록으로 구성됩니다. 각 항목은 링크이며, 콜론 뒤에 선택적으로 설명을 붙일 수 있습니다.
## Docs - [Quickstart](https://acme.com/docs/quickstart): Integrate in five minutes - [API reference](https://acme.com/docs/api): Every endpoint and parameter ## Examples - [Sample app](https://acme.com/examples/app): A working end-to-end example
절대 https URL을 사용하고, 설명은 마케팅 문구가 아니라 개발자나 모델이 필요로 하는 내용에 초점을 맞추세요.
5. 부가적인 항목에는 "Optional" 섹션 사용하기
## Optional이라는 이름의 섹션은 부차적 정보를 위한 관행입니다. 더 짧은 컨텍스트가 필요할 때 에이전트가 건너뛸 수 있는 링크를 넣습니다. 변경 이력, 블로그 글, 이차 참고 자료를 여기에 두세요.
6. 루트에 두거나 — 포괄하는 경로에 두세요
파일은 https://yourdomain.com/llms.txt에서 Content-Type: text/plain으로 제공하세요. 하위 경로에 두어 그 아래 페이지들을 포괄하게 할 수도 있습니다. /docs/llms.txt는 /docs/ 아래 모든 것을 설명하며, 에이전트는 해당되는 것 중 가장 구체적인 파일을 선호합니다(스펙 v2에서 바뀐 점 참고). 큰 사이트는 내용을 전부 펼친 llms-full.txt도 함께 게시하는 경우가 많습니다.
7. 페이지가 파일을 가리키게 하세요
에이전트가 URL을 추측하지 않도록, 각 페이지에서 <link rel="describedby" href="/llms.txt">로 파일을 알리세요. 동등한 Link: 응답 헤더로도 되며, 그 경우 CDN 설정에 한 번만 넣으면 됩니다.
8. 배포 전에 검증하기
도메인을 검증기에 붙여넣으세요. 구조를 확인하고, 모든 링크가 실제로 연결되는지 검증하며, 무엇을 고쳐야 하는지 정확히 알려줍니다. 100/100을 목표로 하세요.