> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/ja-gitbook-documentation/ai-to/llm-ready-docs.md).
# LLM 対応ドキュメント
大規模言語モデル（LLM）が、ドキュメントの内容を取り込み、扱うことをより簡単にする機能を構築しています。
LLMが情報検索やナレッジ支援においてますます重要になるにつれ、ドキュメントをLLM向けに整えることで、これらのモデルがあなたの製品やサービスをどのように理解し表現するかを大幅に改善できます。
LLM向けに最適化されたドキュメントは、ChatGPT、Claude、Cursor、Copilot のようなAIシステムが、あなたの製品やAPIに関する正確で文脈に沿った応答を取得し、提供できるようにします。
## .md ページ
GitBook では、ドキュメントサイトのすべてのページが自動的に markdown ファイルとして利用可能になります。もし `.md` 拡張子を任意のページに追加すると、そのページの内容が markdown 形式で表示され、HTMLファイルよりも効率的に処理できるため LLM に渡すことができます。
このページの .md ファイルを見る
## llms.txt
[llms.txt](https://llmstxt.org/) は、LLM が処理しやすいテキストベースの形式で Web コンテンツを利用可能にするための提案標準です。 `llms.txt` ページは `/llms.txt` をドキュメントサイトのルートURLに付けることでアクセスできます。
この `llms.txt` ファイルは、ドキュメントサイトの索引として機能し、利用可能なすべての markdown 形式のページの包括的な一覧を提供します。このファイルにより、LLM がドキュメント内容を効率的に見つけて処理しやすくなります。
GitBook のドキュメントの /llms.txt を確認する
## llms-full.txt
一方で `llms.txt` ファイルには、ドキュメントサイト内のすべてのページURLとタイトルの索引が含まれますが、 `llms-full.txt` には、ドキュメントサイトの全内容が 1 つのファイルにまとめられており、LLM にコンテキストとして渡すことができます。
非表示のページは `llms-full.txt`に含まれます。ページを非表示にしても、公開された目次から削除されるだけです。
GitBook のドキュメントの /llms-full.txt ファイルを確認する
LLM はこの索引を使って、ページの markdown 版へ直接移動できるため、HTML を解析しなくてもドキュメントをコンテキストに取り込めます。
## 公開済みドキュメント向けの MCP サーバー
GitBook は、公開済みの各サイトに対して Model Context Protocol（MCP）サーバーを自動的に公開します。MCP により、AI ツールはスクレイピング不要で、ドキュメントをリソースとして構造的に見つけて取得できます。
非表示のページはサイトの MCP サーバー経由でも引き続き利用できます。ページを非表示にしても、公開された目次から削除されるだけです。
あなたの MCP サーバーには、 `/~gitbook/mcp` をドキュメントサイトのルートのURLに付けることでアクセスできます。たとえば、GitBook のドキュメント用 MCP サーバーは `https://gitbook.com/docs/~gitbook/mcp`.
{% hint style="info" %}
にあります。このURLをブラウザで開くとエラーになります。代わりに、LLM や IDE のような HTTP リクエストを送信できるツールと共有してください。
{% endhint %}
詳しくは [公開ドキュメント向け MCP サーバー](/docs/documentation/ja-gitbook-documentation/ai-to/mcp-servers-for-published-docs.md).
## LLM 向けにドキュメントを最適化するためのヒント
GitBook サイトが自動的に `.md` ページ、 `llms.txt`、および `llms-full.txt` ファイルを生成するようになったので、これらのベストプラクティスは LLM があなたのコンテンツを効果的に理解し、扱うのに役立ちます。
これらの最適化を使うことで、AI 搭載検索エンジンや生成エンジン最適化（GEO）でのドキュメントのパフォーマンス向上にもつながる可能性があります。
さらに良い点は？ これらのガイドラインは、一般的に人にとってもドキュメントを読みやすくします。
### 明確で階層的な構造を使う
見出し（H1、H2、H3）を適切に使って内容を区切り、長文の塊をそのまま書かないようにしましょう。箇条書き、番号付きリスト、短い段落にすると、すべてが読みやすくなります。
### 簡潔で専門用語の少ない内容を書く
できるだけシンプルにし、本当に必要な場合を除いて複雑な技術用語は避けましょう。LLM は、余計な装飾を加えずに言いたいことをそのまま伝えると、よりよく理解します。
### 実践的な例を含める
説明するだけでなく、実際に見せましょう。コードスニペット、API の例、実際のシナリオは、LLM にもユーザーにも、物事が実際にどう動くのかを理解する助けになります。
### 内容を最新かつ正確に保つ
古いドキュメントは誰も好みません。定期的に更新することで、LLM が最新機能や更新について誤った情報を伝えるのを防げます。
### AI ツールでテストする
実際に ChatGPT や Claude にドキュメントについて質問してみて、内容をどれだけ理解しているか確認してください。うまくいく点とそうでない点に驚くかもしれません。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/ai-to/llm-ready-docs.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.