> 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/getting-started/llm-ready-docs.md).

# LLM対応ドキュメント

公開したドキュメントを、AI ツールが見つけ、読み、使いやすくしましょう

GitBook は、ドキュメントサイト向けに AI に適した形式を自動で公開します。

これらは、大規模言語モデル（LLM）、コーディングエージェント、AI 検索システムに役立ちます。これらのツールは、HTML を解析せずに正確なドキュメントを見つけて取得できます。

## Markdown ページ

追加する `.md` を公開済みページの URL に付けると、その Markdown を表示できます。Markdown は、周囲の HTML なしで AI ツールに構造化されたコンテンツを提供します。

<a href="https://gitbook.com/docs/publishing-documentation/llm-ready-docs.md" class="button primary">このページの .md ファイルを見る</a>

## llms.txt

[llms.txt](https://llmstxt.org/) は、LLM に適した Web コンテンツのための提案標準です。 `/llms.txt` をドキュメントサイトのルート URL に追加します。

公開済みのすべてのページを Markdown 版とともに一覧表示します。AI ツールはこのインデックスを使ってドキュメントを見つけられます。

<a href="https://gitbook.com/docs/llms.txt" class="button primary">GitBook ドキュメントの /llms.txt を見る</a>

## llms-full.txt

追加する `/llms-full.txt` をドキュメントサイトのルート URL に追加します。このファイルには、すべてのドキュメントコンテンツが 1 か所にまとめられています。

非表示ページは `llms-full.txt`に含まれます。ページを非表示にしても、公開済みの目次から削除されるだけです。

<a href="https://gitbook.com/docs/llms-full.txt" class="button primary">GitBook ドキュメントの /llms-full.txt ファイルを見る</a>

## 公開済みドキュメント向け MCP サーバー

GitBook は、公開済みのすべてのドキュメントサイトに Model Context Protocol（MCP）サーバーを提供します。対応ツールは、構造化されたリソースとしてドキュメントを見つけて取得できます。

非表示ページはサイトの MCP サーバーからも利用できます。ページを非表示にしても、公開済みの目次から削除されるだけです。

追加する `/~gitbook/mcp` をドキュメントサイトのルート URL に追加します。たとえば、GitBook の MCP サーバーは `https://gitbook.com/docs/~gitbook/mcp`.

{% hint style="info" %}
この URL をブラウザで開くとエラーが返されます。HTTP リクエストを送信できるツールを使用してください。
{% endhint %}

詳細は [公開ドキュメント向け MCP サーバー](/docs/documentation/ja-gitbook-documentation/ai-for-your-readers/mcp-servers-for-published-docs.md).

## AI 向けにドキュメントを最適化する

GitBook は配信レイヤーを担当します。あなたの文章が AI の回答の質を左右します。

AI ツールが確実に解釈できるコンテンツを書きましょう：

* 各ページに明確な目的を持たせます。
* 説明的な見出しと短いセクションを使います。
* 制約、既定値、要件を直接記載します。
* 具体例と正確な値を含めます。
* 製品が変わったら内容を更新します。

これらの実践は検索性を高め、曖昧さを減らし、人が答えを見つけやすくします。

### 翻訳の整合性を保つ

複数の言語で公開する場合は、各翻訳を元の内容と一致させてください。

[翻訳](/docs/documentation/ja-gitbook-documentation/gitbook-jento/translations.md) GitBook Agent を使ってコンテンツをローカライズできます。元のコンテンツが変更されると、GitBook は翻訳版の整合性を保てます。

### AI トラフィックの測定

次を使用 [Agents & MCP](/docs/documentation/ja-gitbook-documentation/analytics/insights/agents-and-mcp.md) サイト分析のレポートを使用して、LLM や MCP クライアントからのトラフィックを追跡します。


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/getting-started/llm-ready-docs.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
