# GitBookアシスタント

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FSYnigoIgRCsPtDbJ4UKr%2F23_07_25_gitbook_assistant.svg?alt=media&#x26;token=384d57b1-fe51-464f-b000-fd7450f250a7" alt="GitBook Assistant"><figcaption><p>GitBookアシスタント</p></figcaption></figure>

GitBookアシスタントは、自然言語を使ってドキュメントに関する迅速かつ正確な回答をユーザーに提供します。ユーザーごとにパーソナライズされ、ウェブサイトや製品に埋め込むことができ、公開されたドキュメントのサイドバーでも利用できます。

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

アシスタントはエージェント的な検索（agentic retrieval）を使用して、ユーザーの現在のページ、以前に読んだページ、過去の会話に基づいてクエリの文脈を理解します。

下のボックスにアシスタントへの質問を入力してみてください：

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

### GitBookアシスタントを有効にする <a href="#how-do-i-use-gitbook-ai" id="how-do-i-use-gitbook-ai"></a>

GitBookアシスタントを有効にするには、サイトのダッシュボードを開き、 **設定** ページに移動して **AI と MCP** 左側のメニューから選択します。ここで利用可能なオプションからGitBookアシスタントを有効にできます。

#### 推奨質問を追加する

推奨質問は、アシスタントが会話を開始していない状態で開かれたときに表示される事前作成のプロンプトです。ユーザーが何を尋ねられるかを理解するのに役立ち、有用な回答やワークフローへユーザーを誘導するのに役立ちます。

推奨質問はサイトの **設定**にある **AI と MCP** セクションから選択します。

**推奨質問に関するベストプラクティス：**

* 実際のユーザーの目的（セットアップ、トラブルシューティング、統合）から始めてください。
* ユーザーが使う言葉を使ってください（内部コードネームは避けてください）。
* 具体的にしてください。「どうやって…？」は「…について教えて」より優れます。
* 異なる意図をカバーしてください：クイックスタート、ハウツー、トラブルシューティング、リファレンス。

{% hint style="info" %}
製品内にアシスタントを埋め込む場合、埋め込み設定で動的に提案を設定することもできます。参照： [Embedのカスタマイズ](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/publishing-documentation/embedding/configuration/customizing-docs-embed#adding-suggestions).
{% endhint %}

### 公開されたドキュメントでのGitBookアシスタントの使用 <a href="#how-do-i-use-gitbook-ai" id="how-do-i-use-gitbook-ai"></a>

ユーザーは3つの方法でGitBookアシスタントにアクセスできます：

* を押す <kbd>⌘</kbd> + <kbd>I</kbd> Macでは、あるいは <kbd>Ctrl</kbd> + <kbd>I</kbd> PC上で
* をクリックします **GitBookアシスタント**

  <picture><source srcset="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FFdcFnImj64xwVYVPFZZp%2Fgitbook-assistant-dark.svg?alt=media&#x26;token=6d5690e2-8587-4646-886a-dfd49caee6d5" media="(prefers-color-scheme: dark)"><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FRPCVZqnhQlwvRJbvEgM9%2Fgitbook-assistant.svg?alt=media&#x26;token=0506ce84-b363-481b-aefb-e0fa47357226" alt=""></picture>

  の横にあるボタン **質問するか検索する…** バー
* バーに質問を入力し、メニュー上部の「Ask…」オプションを選択してください **質問するか検索する…** バーに質問を入力し、メニュー上部の「Ask…」オプションを選択してください

{% if visitor.claims.unsigned.reflag.EMBED\_ASSISTANT\_PANEL == true %}
**GitBookアシスタントを製品に埋め込む**

GitBookアシスタントを製品やウェブサイトに直接埋め込むことで、ユーザーはアプリケーションを離れずにAIによるサポートに即座にアクセスできます。アシスタントは次の一部として埋め込むことができます： [Docs Embed](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/embedding)には、AIによるチャット用のアシスタントタブとドキュメント閲覧用のDocsタブの両方が含まれます。

ご利用のスタックに合った埋め込み方法を選んでください：

* [**単体のスクリプトタグ**](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/embedding/implementation/script) – 次のもので簡単にセットアップ： `<script>` タグ
* [**Node.js/NPM**](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/embedding/implementation/nodejs) – サーバーサイドまたはビルド時の統合
* [**Reactコンポーネント**](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/embedding/implementation/react) – 既成のReactコンポーネント

**追加ガイド：**

* [認証付きドキュメントでの利用](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/embedding/using-with-authenticated-docs) – ドキュメントにサインインが必要な場合は必須
* [Embedのカスタマイズ](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/embedding/configuration/customizing-docs-embed) – ウェルカムメッセージ、アクション、および提案
* [カスタムツールの作成](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/embedding/configuration/creating-custom-tools) – アシスタントをあなたのAPIに接続する
* [API リファレンス](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/embedding/configuration/reference) – 利用可能なすべての方法とイベント
  {% endif %}

### MCPサーバーでGitBookアシスタントを拡張する

外部データソースをGitBookアシスタントに追加して、より多くの文脈やデータから回答を引き出せるようにすることもできます。これは、次のような外部プラットフォーム向けのMCPサーバーをアシスタントに接続することで行えます：

* コミュニティ（Slack、Discord、GitHub Communities など）
* サポートツール（Intercom など）
* 将来の製品ロードマップ（GitHub、Linear など）
* 製品との外部統合に関するドキュメント

GitBookアシスタントにMCPサーバーを追加するには、次の手順に従ってください：

{% stepper %}
{% step %}
**サイトの設定を開く**

サイトのダッシュボードに移動し、サイトヘッダーから **設定** オプションを選択します。次に左側のメニューから **AI と MCP** セクションを選択します。
{% endstep %}

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

ページの下部には接続されているすべてのMCPサーバーを示す表があります。新しいサーバーを追加するには、 **Add MCP server**
{% endstep %}

{% step %}
**MCPサーバーを選択する**

サーバーを追加するには、名前を付け、サーバーのURLを追加し、ユーザーがクエリを送信したときにサーバーへリクエストとともに送られるHTTPヘッダーを構成する必要があります。
{% endstep %}
{% endstepper %}
