よくある llms.txt のミス
公開日:
llms.txt の問題のほとんどは、いくつかのパターンに分類できます。ここでは、私たちのバリデーターが最も頻繁に検出するものと、それぞれの手早い修正方法を紹介します。
1. H1 が複数ある
仕様では、最上位の # Title はちょうど 1 つだけにすることが求められます。余分な # 見出しは構造を混乱させます。残りは ## のセクション見出しに格下げしましょう。
2. ブロッククォートのサマリーがない
タイトルのすぐ下にある 1〜2 文のブロッククォートは、モデルが最初に読むコンテキストです。これを省略するのは、最もよくある見落としです。次のように追加しましょう。
# Acme > Acme turns CSV files into charts. These links cover setup, the API, and pricing.
3. リンクのないセクション（あるいはセクションがまったくない）
空の ## セクションには何の意味もありません。各セクションには、実在するページへのリンクを Markdown の箇条書きリストとして含めるべきです。セクションがまったくない場合は、主要なページを ## Docs や ## Guides のような見出しの下にまとめましょう。
4. リンク切れ
ファイルの書式が完璧でも、リンク先が存在しないページを指していることがあります。これはクローラーのバジェットを浪費し、信頼を損ないます。すべての URL は解決できなければなりません。これはほとんどのツールが省略するチェックですが、私たちは一つひとつを実際に取得して確認します。
5. 相対リンクや http:// のリンク
どこでも絶対 https:// URL を使いましょう。モデルは /docs/start のような相対パスを解決できない場合があり、また素の http:// リンクは信頼性に欠けて見え、HTTPS のみのクローリングでは機能しなくなることがあります。
6. 誤ったコンテンツタイプ
ファイルは text/plain; charset=utf-8 として配信しましょう。サーバーが text/html を返す（よくある設定ミスです）場合、一部のコンシューマーはそれを llms.txt として扱いません。
7. 肥大化し、整理されていないファイル
llms.txt は厳選されたインデックスであって、サイトマップの丸ごとのコピーではありません。説明のない数百ものリンクはシグナルを埋もれさせます。最良のページだけを残し、それぞれの後に短い : description を付け、二次的なリンクは ## Optional セクションに移しましょう。
すべてをまとめて検出する
ファイルをバリデーターに通してみましょう。構造、リンクの到達可能性、ベストプラクティスを評価し、上記のうちどれを直すべきかを正確に教えてくれます。この形式が初めてですか？まずはllms.txt ファイルの作り方から始めましょう。