> 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/gitbook-ai-assistant.md).

# GitBook Assistant

{% hint style="info" %}
この機能は〜で利用できます [アルティメットサイトプラン](https://www.gitbook.com/pricing).
{% endhint %}

<figure><img src="/files/88ec79649ec7c356cd9629fdafa2276e7302f3f5" alt="GitBook Assistant"><figcaption><p>GitBook Assistant</p></figcaption></figure>

GitBook Assistant は、自然言語を使ってドキュメントに関する正確で素早い回答をユーザーに提供します。ユーザーごとにパーソナライズされ、Webサイトや製品に埋め込むことができ、公開済みドキュメントのサイドバーでも利用できます。

必要な場所とタイミングで、すべてのユーザーが利用できる製品の専門家のようなものだと考えてください。

Assistant はエージェント的リトリーバルを使用して、ユーザーの現在のページ、以前に読んだページ、過去の会話に基づいてクエリの文脈を理解します。

下のボックスで Assistant に質問してみてください:

<p align="center"><button type="button" class="button primary" data-action="ask" data-icon="gitbook-assistant">質問を入力...</button></p>

## GitBook Assistant を有効にする <a href="#how-do-i-use-gitbook-ai" id="how-do-i-use-gitbook-ai"></a>

GitBook Assistant を有効にするには、 **カスタマイズ**、の **ツール** をサイトのサイドバーで開き、 **AI アシスタント**をクリックします。ここで、利用可能なオプションから GitBook Assistant を有効にできます。

### おすすめの質問を追加する

おすすめの質問は、Assistant がアクティブな会話なしで開かれたときに表示される、あらかじめ作成されたプロンプトです。ユーザーが何を質問できるかを理解する助けになり、役立つ回答やワークフローへユーザーを導くのにも役立ちます。

サイトの **設定**の **AI & MCP** セクションでおすすめの質問を追加できます。

#### **おすすめの質問のベストプラクティス:**

* 実際のユーザーの目的から始める（セットアップ、トラブルシューティング、統合）。
* ユーザーが使う言葉を使う（社内コードネームは避ける）。
* 具体的にする。「〜はどうすればいい？」は「〜について教えて」より良いです。
* さまざまな意図をカバーする: クイックスタート、手順、トラブルシューティング、リファレンス。

{% hint style="info" %}
Assistant を製品に埋め込む場合は、埋め込み設定で提案内容を動的に設定することもできます。こちらを参照してください: [埋め込みのカスタマイズ](/docs/documentation/ja-gitbook-documentation/docs-site/embedding/configuration/customizing-docs-embed.md#adding-suggestions).
{% endhint %}

## 公開済みドキュメントで GitBook Assistant を使う <a href="#how-do-i-use-gitbook-ai" id="how-do-i-use-gitbook-ai"></a>

ユーザーは GitBook Assistant に 3 つの方法でアクセスできます:

* 押す <kbd>⌘</kbd> + <kbd>I</kbd> （Mac の場合）または <kbd>Ctrl</kbd> + <kbd>I</kbd> （PC の場合）
* をクリックする **GitBook Assistant** <picture><source srcset="/files/KOSE771IpEtAlfLNdKX1" media="(prefers-color-scheme: dark)"><img src="/files/ad2de5ee4a387c893e0b483fa46ca02f60c7f628" alt=""></picture> ボタンの隣にある **質問または検索…** バー
* に質問を入力し、メニュー上部の「質問する…」オプションを選択する **質問または検索…** バー

## 製品に GitBook Assistant を埋め込む

GitBook Assistant を製品や Web サイトに直接埋め込むことで、ユーザーはアプリケーションを離れずに AI 搭載のヘルプに即座にアクセスできます。Assistant は [Docs Embed](/docs/documentation/ja-gitbook-documentation/docs-site/embedding.md)の一部として埋め込むことができ、これには AI 搭載チャット用の Assistant タブ、範囲を絞った検索用の Search タブ、ドキュメントを閲覧するための Docs タブが含まれます。

スタックに合った埋め込み方法を選んでください:

* [**スタンドアロンのスクリプトタグ**](/docs/documentation/ja-gitbook-documentation/docs-site/embedding/implementation/script.md) – 次を使った簡単なセットアップ `<script>` タグ
* [**Node.js/NPM**](/docs/documentation/ja-gitbook-documentation/docs-site/embedding/implementation/nodejs.md) – サーバーサイドまたはビルド時の統合
* [**React コンポーネント**](/docs/documentation/ja-gitbook-documentation/docs-site/embedding/implementation/react.md) – 事前構築済みの React コンポーネント

### 追加の Assistant 埋め込みガイド:

* [認証済みドキュメントで埋め込み Assistant を使う](/docs/documentation/ja-gitbook-documentation/docs-site/embedding/using-with-authenticated-docs.md) – ドキュメントにサインインが必要な場合に必須
* [Assistant 埋め込みのカスタマイズ](/docs/documentation/ja-gitbook-documentation/docs-site/embedding/configuration/customizing-docs-embed.md) – ウェルカムメッセージ、アクション、提案
* [カスタム埋め込みツールの作成](/docs/documentation/ja-gitbook-documentation/docs-site/embedding/configuration/creating-custom-tools.md) – Assistant を API に接続する
* [API リファレンス](/docs/documentation/ja-gitbook-documentation/docs-site/embedding/configuration/reference.md) – 利用可能なすべてのメソッドとイベント

## GitBook Assistant の知識を拡張する

GitBook Assistant は、 [接続](/docs/documentation/ja-gitbook-documentation/ai-to/connections.md) や [MCP サーバー](/docs/documentation/ja-gitbook-documentation/ai-to/mcp-servers-for-published-docs.md).

を通じて外部の知識を利用できます。GitBook にレコードをサイトへ同期させたい場合は接続を使い、GitBook Assistant をカスタムツールに接続したい場合は MCP サーバーを使います。

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th>最適な用途</th></tr></thead><tbody><tr><td><strong>接続</strong></td><td><p>接続は、コンテンツ量の多いソースに最適です:</p><ul><li>GitHub の issue とディスカッション</li><li>Slack または Discord の会話</li><li>サポートコンテンツ</li><li>外部ドキュメント、ヘルプセンター、Web サイト</li></ul></td></tr><tr><td><strong>MCP サーバー</strong></td><td><p>MCP サーバーは、ライブのツールやデータに最適です:</p><ul><li>現在のアカウントまたは製品の状態</li><li>頻繁に変化する社内システム</li><li>チケット作成やバグ報告などのアクション</li><li>GitBook に同期したくないソース</li></ul></td></tr></tbody></table>

{% tabs %}
{% tab title="接続を追加する" %}
{% stepper %}
{% step %}
**サイトの設定を開く**

サイトのダッシュボードを開きます。次に **設定** → **接続**.
{% endstep %}

{% step %}
**ソースを接続する**

ソースの種類を選択します。その後、認証するか、インポートする URL を入力します。
{% endstep %}

{% step %}
**レコードを GitBook Assistant に公開する**

オンにする **検索 / assistant に公開** を接続に対して有効にします。

その後 GitBook は、それらのレコードを検索と GitBook Assistant で使用できます。
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="MCP サーバーを追加する" %}
{% stepper %}
{% step %}
**サイトの設定を開く**

サイトのダッシュボードを開きます。次に **設定** → **AI & MCP**.
{% endstep %}

{% step %}
**新しいサーバーを追加する**

MCP サーバーのテーブルで、 **MCP サーバーを追加**.
{% endstep %}

{% step %}
**サーバー詳細を入力する**

サーバーに名前を付けます。URL を追加します。

その後、GitBook が各リクエストとともに送信する必要がある HTTP ヘッダーを設定します。
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}


---

# 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/gitbook-ai-assistant.md?ask=<question>&goal=<endgoal>
```

`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.