GitBook Assistant

GitBook Assistantは、ドキュメントだけでなく、ナレッジベース全体から引き出した正確で文脈に沿った回答をユーザーに提供します

GitBook アシスタント

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

これは、必要な場所とタイミングでいつでも利用できる、すべてのユーザー向けの製品エキスパートのようなものだと考えてください。

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

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

GitBook Assistant を有効にする

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

提案質問を追加する

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

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

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

• 実際のユーザーの目的（セットアップ、トラブルシューティング、連携）から始める。

• ユーザーが使う言葉を使う（内部コードネームは避ける）。

• 具体的にする。「How do I…?」は「Tell me about…」より適しています。

• さまざまな意図をカバーする: クイックスタート、使い方、トラブルシューティング、リファレンス。

Assistant を製品に埋め込む場合は、埋め込み設定で提案を動的に設定することもできます。参照: Embed のカスタマイズ.

公開済みドキュメントで GitBook Assistant を使用する

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

• を押す ⌘ + I Macでは、または Ctrl + I PC で

• 次のボタンをクリックします GitBook Assistant ボタンの横にある 質問するか検索… バー

• 質問を 質問するか検索… バーに入力し、メニュー上部の「Ask…」オプションを選択します

GitBook Assistant を製品に埋め込む

GitBook Assistant を製品や Webサイトに直接埋め込むことで、ユーザーはアプリケーションを離れることなく AI 搭載のヘルプにすぐアクセスできます。Assistant は、の一部として埋め込むことができます。 Docs Embed。これには、AI 搭載チャット用の Assistant タブと、ドキュメントを閲覧するための Docs タブの両方が含まれます。

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

• 単独の script タグ – を使った簡単なセットアップ <script> タグ

• Node.js/NPM – サーバーサイドまたはビルド時の統合

• React コンポーネント – 事前構築済みの React コンポーネント

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

• 認証済みドキュメントで埋め込み Assistant を使用する – ドキュメントへのサインインが必要な場合に必須

• Assistant の埋め込みをカスタマイズする – ウェルカムメッセージ、アクション、提案

• カスタム埋め込みツールを作成する – Assistant を API に接続する

• API リファレンス – 利用可能なすべてのメソッドとイベント

GitBook Assistant の知識を拡張する

GitBook Assistant は、 接続 、 MCP サーバー.

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

接続

最適な用途

接続は、コンテンツ量の多いソースに最適です:

• GitHub の issue とディスカッション

• Slack または Discord の会話

• サポートコンテンツ

• 外部ドキュメント、ヘルプセンター、Webサイト

MCP サーバー

最適な用途

MCP サーバーは、ライブツールやデータに最適です:

• 現在のアカウントまたは製品の状態

• 頻繁に変更される社内システム

• チケット作成やバグ報告などのアクション

• GitBook に同期したくないソース

接続を追加する

1

サイトの設定を開く

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

2

ソースを接続

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

3

レコードを GitBook Assistant に公開する

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

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

MCP サーバーを追加する