게시하기 전에 llms.txt 파일의 유효성을 검사하는 방법

깨진 llms.txt은 llms.txt이 없는 것보다 더 나쁩니다. 파일의 형식이 잘못된 경우 해당 파일을 do 읽는 도구와 모델은 사이트에 대한 혼란스럽거나 불완전한 그림을 얻습니다. 이는 여러분이 원하는 것과 반대입니다. 좋은 소식: llms.txt 형식은 간단하므로 무엇을 확인해야 할지 알면 유효성 검사가 빠릅니다.

이는 게시할 때마다 실행할 수 있는 실용적이고 간결한 체크리스트입니다.

실제로 필요한 형식

llms.txt 형식(llmstxt.org의)은 의도적으로 마크다운을 최소화합니다.

프로젝트 이름을 지정하는 단일 H1 제목, 파일의 첫 번째 줄.
제목 바로 뒤에는 선택사항이지만 권장되는 요약 인용문(> …)이 있습니다.
0개 이상의 H2 섹션(## Docs, ## API, …), 각 섹션에는 링크 목록이 포함되어 있습니다.
각 링크는 - [Name](https://example.com/page): short description 목록 항목입니다.

그것이 전체 구조입니다. 대부분의 검증 문제는 이 형태에서 벗어나는 것입니다.

게시 전 체크리스트

1. 정확히 하나의 H1, 그리고 첫 번째

파일은 하나의 # Title 줄로 열려야 합니다. 일반적인 실수:

H1이 전혀 없습니다(파일은 산문이나 목록으로 시작됩니다).
다중 H1(섹션에는 ##을 대신 사용).
H1은 다른 콘텐츠 아래에 묻혀있습니다.

2. 요약 인용문

제목 바로 뒤에 사이트나 프로젝트가 무엇인지 설명하는 한 줄짜리 > 인용구를 포함하세요. 모델이든 인간이든 모든 독자에게 즉각적인 맥락을 제공합니다. 사양에서는 선택 사항이지만 실제로는 권장됩니다.

3. 링크를 그룹화하는 섹션

관련 링크를 그룹화하려면 ## 제목을 사용하세요: ## Documentation, ## API Reference, ## Guides. 섹션이 없는 단순 링크 덤프는 탐색하기 어렵습니다. 링크가 여러 개인 경우 그룹화하세요.

4. 올바른 형식의 링크

모든 링크에서 다음 사항을 확인하세요.

빈 URL, [Docs]()에는 괄호 안에 내용이 없습니다.
링크 텍스트 누락, 라벨이 없는 [](https://…).
잘못된 URL, 오타, https:// 누락, 잘못된 문자.
중복 링크, 동일한 URL이 두 번 이상 나타나면 공간을 낭비하고 복사하여 붙여넣기 오류가 발생했음을 나타냅니다.

5. 모든 링크에 대한 설명

순수 - [Quickstart](https://…)은 - [Quickstart](https://…): Get set up in five minutes보다 훨씬 덜 유용합니다. 설명은 모델에게 링크가 중요한 _이유_와 이를 따라야 하는 _언제_를 알려줍니다. 모든 목록 항목 링크에 하나를 추가합니다.

6. 간결하게 작성하세요

llms.txt은 아카이브가 아닌 인덱스입니다. 파일이 매우 큰 경우(수십 킬로바이트 이상), 이는 선별된 링크 목록이 속한 곳에 전체 콘텐츠를 채우고 있다는 신호입니다.

7. llms-full.txt와 함께 사용하는 것을 고려해보세요.

실제로 원하는 긴 형식의 콘텐츠 모델이 많은 경우 전체 텍스트가 포함된 별도의 llms-full.txt을 게시하고 llms.txt을 이에 연결되는 경량 맵으로 유지하세요.

클린 파일의 간단한 예

# Acme Docs

> Acme is an API for sending transactional email. This file indexes the docs and reference.

## Getting Started

- [Quickstart](https://acme.dev/quickstart): Send your first email in five minutes
- [Authentication](https://acme.dev/auth): API keys and scopes

## API Reference

- [Messages API](https://acme.dev/api/messages): Create and send messages
- [Webhooks](https://acme.dev/api/webhooks): Delivery and bounce events

## Optional

- [Changelog](https://acme.dev/changelog): Release notes

하나의 H1, 요약, 그룹화된 섹션, 설명된 링크, 중복 없음. 그것이 목표입니다.## 자동으로 유효성을 검사합니다

체크리스트를 직접 실행하는 것은 효과적이지만 긴 파일에서 중복된 URL이나 누락된 설명을 놓치기 쉽습니다. 무료 llms.txt 유효성 검사기는 위의 모든 사항을 한 번에 확인하고 구조 점수와 라인 인식 특정 제안을 제공합니다.

다음 두 가지 방법으로 유효성을 검사할 수 있습니다.

콘텐츠를 유효성 검사기에 직접 붙여넣거나
URL을 입력하세요, 귀하의 사이트를 가리키거나(/llms.txt을 자동으로 가져옵니다) 파일에 바로 연결합니다. 이는 이미 활성화된 파일을 확인하는 데 유용합니다.

어느 쪽이든 게시하기 전이나 후에 수정해야 할 사항을 정확히 확인할 수 있습니다.

문제를 해결한 후

검증인이 만족하면:

파일을 llms.txt으로 저장하고 도메인 루트(https://example.com/llms.txt)에 업로드합니다.
실제 URL에 대해 유효성 검사기를 다시 실행하여 일반 텍스트로 제공되고 연결 가능한지 확인합니다.
사이트를 재구성하거나 주요 섹션을 추가할 때마다 다시 확인하세요.

결론

유효성 검사에는 몇 분 정도 소요되며 파일을 읽는 도구를 조용히 오도하는 파일을 전달하는 일을 방지할 수 있습니다. 게시하기 전에 체크리스트를 실행하고 구조를 수정한 후 검증기로 확인하세요.

아직 파일이 없나요? llms.txt 생성기를 사용하여 사이트에서 깨끗한 초안을 생성한 다음 유효성을 검사하세요. 그리고 아직 필요한지 결정하고 있다면 llms.txt가 의미가 있는 경우를 참조하세요.