GitBook Assistant

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

GitBook アシスタント

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

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

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

下のボックスで Assistant に質問してみましょう:

GitBook Assistant を有効にする

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

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

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

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

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

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

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

• 具体的にする。「どうやって…？」は「…について教えて」より効果的です。

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

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

公開済みドキュメントで GitBook Assistant を使う

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

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

• をクリックする GitBook Assistant ボタンを Ask or search… バーの横で

• 質問を入力して Ask or search… バーを開き、メニュー上部の「Ask…」オプションを選択する

GitBook Assistant を製品に埋め込む

GitBook Assistant を製品やウェブサイトに直接埋め込むことで、ユーザーはアプリケーションを離れることなく、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 の会話

• サポートコンテンツ

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

MCP サーバー

最適な用途

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

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

• 頻繁に変化する内部システム

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

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

接続を追加する

1

サイト設定を開く

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

2

ソースを接続

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

3

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

をオンにする 検索 / assistant に公開 をその接続で有効にします。

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

MCP サーバーを追加する