AI アシスタント

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

AI アシスタントは、自然言語を使って、ドキュメントに関する迅速で正確な回答をユーザーに提供します。ユーザーごとにパーソナライズされており、ウェブサイトや製品に埋め込むことができ、公開済みドキュメントのサイドバーや検索ボックスに表示できます。

必要なとき、必要な場所で、すべてのユーザーが利用できる製品のエキスパートだと考えてください。

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

AIアシスタントは使用します AIクレジット. 関連のある回答に対してのみクレジットが消費されます。

以下のボックスでアシスタントに質問してみてください:

AI アシスタントを設定

AI アシスタントを設定するには、開いてください カスタマイズ サイトのサイドバーで開き、クリックします AI アシスタント。ここでアシスタントを有効化し、指示、ウェルカムメッセージ、推奨質問をカスタマイズできます。

カスタム指示を追加

カスタム指示はアシスタントの口調を調整し、製品固有の知識や用語を追加するため、回答が常にあなたの全体的なスタイルに一致します。

カスタム指示はアシスタントの口調と知識を洗練します。組み込みのガードレールを上書きすることはできません。

ウェルカムメッセージをカスタマイズ

ウェルカムメッセージは、アクティブな会話がない状態で訪問者がアシスタントを開いたときに最初に目にするものです。期待値を設定したり、特定のワークフローへユーザーを誘導したりするために使えます。

推奨質問を追加

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

推奨質問のベストプラクティス:

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

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

アシスタントの表示場所を選択

下に外観、設定すると配置読者がアシスタントにアクセスする場所を選択できます:

サイドバー (デフォルト): AI Assistant Chat、完全なチャット体験。Ultimate サイトプランで利用できます。
検索ボックス: AI Assistant Ask、キーワード検索結果の横にインラインで回答を表示します。Essential および Ultimate サイトプランで利用できます。

アシスタントのあいさつはサイドバー配置にのみ適用されるため、〜の間は非表示になります配置が〜に設定されている 検索ボックス.

オフにして AI アシスタント もう一度オンにするとリセットされます配置です。 サイドバー。サイトで検索ボックス配置を使用している場合は、アシスタントを再度有効化した後にもう一度設定してください。

公開済みドキュメントで AI アシスタントを使用する

読者がアシスタントにアクセスする方法は、その配置によって異なります。

サイドバー配置

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

を押し、 ⌘ + I Mac では、または Ctrl + I PC では
次の GitBook Assistant の横にあるボタンをクリック 質問または検索… バー
に質問を入力し 質問または検索… バーで、メニュー上部の「Ask…」オプションを選択します

検索ボックス配置

〜を配置に設定すると 検索ボックス、ユーザーは直接 質問または検索… ページ上部のバーで、キーワード結果と並んで質問できます。

これを直接クリックするか、次を押すことで開けます ⌘ + K Mac では、または Ctrl + K PC で。

要約された回答に加えて、ユーザーは、Assistant が回答の作成に使用したソースを表示する展開可能なセクションと、フォローアップとしてクリックできる関連質問を確認できます。

アシスタントは、ドキュメントサイトの内容と、を通じて追加したあらゆるソースから回答します接続.

アシスタントは、異なる〜にある個別の公開セクションをまたいで回答しませんドキュメントサイト.

マルチセクション検索は、公開済みの〜を表示している場合にのみ利用できます sections 同じサイト内に存在するもの

公開済みドキュメントを検索する

アシスタントがオンかどうかに関係なく、キーワード検索はすべてのサイトで自動的に有効になります。

ユーザーはドキュメントサイト内でキーワードを検索し、サイト全体の特定のページやページセクションへすばやく移動できます。

製品に AI アシスタントを埋め込む

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

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

単独の script タグ – を使った簡単なセットアップ <script> tag
Node.js/NPM – サーバーサイドまたはビルド時の統合
React コンポーネント – 事前構築済みの React コンポーネント

追加のアシスタント埋め込みガイド:

認証済みドキュメントで埋め込みアシスタントを使用する – ドキュメントにサインインが必要な場合に必須
アシスタント埋め込みのカスタマイズ – ウェルカムメッセージ、アクション、提案
カスタム埋め込みツールの作成 – アシスタントを API に接続
API リファレンス – 利用可能なすべてのメソッドとイベント

AI アシスタントの知識を拡張する

AI アシスタントは、〜を通じて外部の知識を利用できます接続と MCP サーバー.

GitBook にレコードをサイトへ同期させたい場合は接続を使用し、AI アシスタントをカスタムツールに接続したい場合は MCP サーバーを使用できます。

接続