llms.txt ファイルの作り方
公開日:
llms.txt ファイルは10分ほどで書けます。本ガイドではすべての構成要素を順を追って説明し、最後にそのまま貼り付けて応用できるファイルを示します。
1. H1 タイトルから始める
最初の行は単一の H1、つまりプロジェクトやサイトの名前でなければなりません。これはこのフォーマットで唯一厳密に必須とされる要素です。
# Acme Docs
2. ブロック引用のサマリーを追加する
タイトルのすぐ下に、1〜2文のブロック引用を追加します。これは言語モデルが最初に読む文脈なので、サイトが何であり、誰のためのものかを具体的に書きましょう。
> Acme is a payments API. This file links to the docs an LLM needs to integrate and debug Acme.
3.（任意）数行の文章を加える
セクション見出しの前に、補足的な案内として通常の段落を加えても構いません。ここでは見出しを使わず、1〜2文にとどめてください。
4. H2 セクションごとにリンクをまとめる
各セクションは H2 見出しに続けて markdown のリストを置きます。各項目はリンクで、コロンの後に任意で説明を付けられます。
## 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 として配信します。大規模なサイトでは、展開済みの全コンテンツを含む llms-full.txt も併せて公開することがよくあります。
7. 公開前に検証する
ドメインをバリデーターに貼り付けてください。構造をチェックし、すべてのリンクが実際に解決するか確認し、修正すべき点を正確に一覧表示します。100/100 を目指しましょう。