# GitBook Assistant

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FlzOUuOwM4Vffctmf3VHC%2F25_03_31_gitbook_assistant%402x.png?alt=media&#x26;token=914e435f-6305-41d8-b05c-23884ceba4e7" alt="GitBook Assistant"><figcaption><p>GitBook アシスタント</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 と MCP** を選択します。ここで利用可能なオプションから GitBook Assistant を有効にできます。

### 提案質問を追加する

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

サイトの **設定**に提案質問を追加できます。 **AI と MCP** セクション内で選択します。

#### **提案質問のベストプラクティス:**

* 実際のユーザーの目的（セットアップ、トラブルシューティング、連携）から始める。
* ユーザーが使う言葉を使う（内部コードネームは避ける）。
* 具体的にする。「How do I…?」は「Tell me about…」より適しています。
* さまざまな意図をカバーする: クイックスタート、使い方、トラブルシューティング、リファレンス。

{% hint style="info" %}
Assistant を製品に埋め込む場合は、埋め込み設定で提案を動的に設定することもできます。参照: [Embed のカスタマイズ](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/publishing-documentation/embedding/configuration/customizing-docs-embed#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="broken-reference" 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…」オプションを選択します

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

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

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

* [**単独の script タグ**](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 コンポーネント

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

* [認証済みドキュメントで埋め込み Assistant を使用する](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/embedding/using-with-authenticated-docs) – ドキュメントへのサインインが必要な場合に必須
* [Assistant の埋め込みをカスタマイズする](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) – Assistant を API に接続する
* [API リファレンス](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/embedding/configuration/reference) – 利用可能なすべてのメソッドとイベント

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

GitBook Assistant は、 [接続](https://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/publishing-documentation/connections) 、 [MCP サーバー](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/mcp-servers-for-published-docs).

を通じて外部知識を利用できます。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 に公開する**

をオンにする **検索 / アシスタントに公開** を接続に対して有効にします。

その後、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 %}