接続

外部ソースをGitBook AssistantとGitBook Agentに接続します

接続を使うと、外部コンテンツをドキュメントサイトに取り込めます。

接続されたコンテンツは AIアシスタントに表示できます。一部の接続では、GitBook が変更リクエストを生成するのにも役立ちます。

接続を追加するには、サイトの設定を開き、次をクリックします接続.

利用可能な接続

サポートプラットフォーム、開発者コミュニティ、その他のコンテンツソースを接続できます。

Intercom、Zendesk、Freshdesk、Front、HubSpot、Zoho Desk、Pylon
GitHub Discussions と GitHub Issues
YouTube、ウェブサイト、または MCP サーバー

接続の仕組み

ソースを接続する

ソースの種類を選択します。次に認証するか、GitBook に取り込みたい URL を入力します。

YouTube を接続する場合は、チャンネル名ではなくチャンネル ID を入力してください。

このソースではチャンネル名は使えません。

YouTube Studio で設定 → チャンネル → 詳細設定.

次をコピーします チャンネル ID.

チャンネル URL に /channel/が含まれている場合は、その後ろの部分をコピーしてください /channel/.

各接続は、そのソースからのレコードの流れを作成します。たとえば、課題、ディスカッション、チケット、会話、ページ、動画などです。

GitBook はレコードを同期します

接続を保存すると、GitBook はそのソースからのレコードの同期を開始します。

接続一覧では、同期ステータス、レコード数、最終同期時刻を確認できます。

接続された URL は、デフォルトで1日1回更新されます。サイトの設定 → 接続.

レコードの使い方を選択する

各接続ごとに、そのレコードを検索や GitBook Assistant に表示するかどうか、また GitBook の変更リクエスト生成に役立てるかどうかを選べます。

また、接続の検索順位を調整して、レコードを優先表示または優先度を下げることもできます。

接続設定

接続を編集すると、次のオプションを設定できます。

ラベル

使用 ラベル 接続にわかりやすい名前を付ける

これにより、特に複数のリポジトリ、ウェブサイト、チャンネルを接続している場合に、接続一覧でソースを識別しやすくなります。

変更リクエストを自動生成

変更リクエストの自動生成は、現在早期アクセス段階です。

以下を参照ドキュメントの自動改善アクセス申請に関する情報はこちら

をオンにします 変更リクエストを自動生成 GitBook が接続のレコードから学習し、ドキュメント更新を提案できるようにする

GitBook はこれらのレコードを使って、チームが確認できる提案変更付きの変更リクエストを作成できます。

検索 / Assistant に公開

をオンにします 検索 / Assistant に公開 この接続のレコードを、訪問者が検索でき、質問への回答に利用できるようにする

これにより、接続されたコンテンツはサイトの AI 搭載検索体験や GitBook Assistant の応答に表示されるようになります。

有効にすると 検索 / Assistant に公開 その接続のレコードが、サイトにアクセスできるすべての人に利用可能になります。サイトが外部共有されている場合は外部訪問者も含まれます。

検索順位のブースト

使用 検索順位のブースト 接続のレコードを検索で優先表示または優先度を下げる

このソースをより頻繁に表示したい場合は値を上げます。主要ドキュメントより重みを下げたい場合は値を下げます。

コネクタの詳細

このセクションのすべてのコネクタは、 AIアシスタントに文脈を提供できます。GitBook Agent は解決済みのレコードを使ってコンテンツの不足箇所を特定し、ドキュメント更新を提案できます。

Intercom

GitBook は、人間または AI のサポートエージェントから少なくとも1件の返信がある解決済みの会話をインデックスします。未解決、未解決のままの会話、またはスパム会話はインデックスしません。

Intercom を接続するには、会話への読み取りアクセス権を持つ API キーを使用してください。スコープと有効期限はご自身で管理できます。

Zendesk

Zendesk を接続するには、次のような Zendesk のサブドメインを入力してください。 gitbook.zendesk.com。また、会話への読み取りアクセス権を持つ API キーも必要です。スコープと有効期限はご自身で管理できます。

Pylon

Pylon を接続するには、会話への読み取りアクセス権を持つ認証情報を使用してください。

GitHub Discussions

GitBook は、少なくとも1件の返信がある解決済みのディスカッションをインデックスします。未解決またはスパムのディスカッションはインデックスしません。

GitHub Discussions を接続するには、ディスカッションへの読み取りアクセス権を持つ認証情報を使用してください。

GitHub Issues

GitBook は解決済みの課題をインデックスします。未解決、未解決のままの会話、またはスパム会話はインデックスしません。

GitHub Issues を接続するには、課題への読み取りアクセス権を持つ認証情報を使用してください。

これらのコネクタで保存されるデータ

GitBook は会話、ディスカッション、または課題のみを保存します。メタデータや個人情報は保存しません。

GitBook は保存前に機密情報をマスクします。インデックスされたレコードには機密情報を保存しません。

データ保持とプライバシー

GitBook は何をインデックスしますか？

GitBook は接続からコンテンツをインデックスし、検索、変更リクエスト、その他のコンテンツ駆動型機能全体で使用します。接続からインデックスする各項目は レコード と呼ばれます。レコードの例には、Intercom のチケット、Freshdesk のチケット、ウェブサイトのページなどがあります。

レコードは、コンテンツ変更の提案や、GitBook 全体で動作するエージェントへの追加の文脈提供に使用されます。

レコードは、ソースが接続されている限り保持されます。接続を削除すると、保存されているレコードはすべて削除されます。ただし、これらのレコードを文脈として生成されたコンテンツや、保存済みの AI 会話ログに含まれるレコードの内容は削除されません。

たとえば、Intercom を接続すると、GitBook はクローズされた Intercom サポートチケットに基づいてドキュメント変更を提案することがあります。その後 Intercom 接続を削除した場合、Intercom 固有の保存データはすべて削除されますが、変更リクエストは残ります。

よくある質問

PII に関するポリシーはどうなっていますか？

一般に、GitBook は文脈として使用できるソースフィールドのみを要求します（各ソースの詳細はコネクタページを参照してください）。

レコードを取り込む際、PII のマスク処理を通します。最初に、メールアドレス、電話番号、住所、その他の個人情報をメモリ上でマスクします。

その後、サードパーティの LLM を使って 2 回目の PII 処理を行います。これは ZDR 準拠の保存しないリクエストで、サードパーティのサーバーには保存されず、いかなる学習にも使用されません。

この前処理を行っている間、PII は数分間当社のサーバー上に存在する場合がありますが、保存するのは後処理済みのレコードのみです。

データをサードパーティに送信しますか？

最初の社内 PII マスク処理が完了した後、PII をマスクするためにサードパーティを使用しています。

変更リクエストの作成やユーザーの質問への回答時にも、マスク済みのレコード内容をサードパーティプロバイダーで使用します。

たとえば、GitBook Agent でコンテンツを書く際、エージェントは外部レコードのコンテンツを追加の文脈として含めることがあります。

GitBook は、自社であれサードパーティ経由であれ、モデル学習にデータを使用しますか

いいえ、レコードデータを学習には使用しません。また、サードパーティプロバイダーが同様に使用していないことも確認しています。

GitBook が取得するレコードを制限できますか？

コネクタ固有の要件とインデックスされるレコードは、以下に記載されていますコネクタの詳細.

最終更新 13 日前

役に立ちましたか？