> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/ja-gitbook-documentation/keno-ai/connections.md). # 接続 接続を使うと、外部コンテンツをドキュメントサイトに取り込めます。 接続されたコンテンツは [AIアシスタント](/docs/documentation/ja-gitbook-documentation/keno-ai/gitbook-ai-assistant.md)に表示できます。一部の接続では、GitBook が変更リクエストを生成するのにも役立ちます。 接続を追加するには、サイトの **設定** を開き、次をクリックします **接続**.
### 利用可能な接続 サポートプラットフォーム、開発者コミュニティ、その他のコンテンツソースを接続できます。 * Intercom、Zendesk、Freshdesk、Front、HubSpot、Zoho Desk、Pylon * GitHub Discussions と GitHub Issues * YouTube、ウェブサイト、または MCP サーバー ### 接続の仕組み {% stepper %} {% step %} #### ソースを接続する ソースの種類を選択します。次に認証するか、GitBook に取り込みたい URL を入力します。 {% hint style="info" %} YouTube を接続する場合は、チャンネル名ではなくチャンネル ID を入力してください。 このソースではチャンネル名は使えません。 YouTube Studio で **設定** → **チャンネル** → **詳細設定**. 次をコピーします **チャンネル ID**. チャンネル URL に `/channel/`が含まれている場合は、その後ろの部分をコピーしてください `/channel/`. {% endhint %} 各接続は、そのソースからのレコードの流れを作成します。たとえば、課題、ディスカッション、チケット、会話、ページ、動画などです。 {% endstep %} {% step %} #### GitBook はレコードを同期します 接続を保存すると、GitBook はそのソースからのレコードの同期を開始します。 接続一覧では、同期ステータス、レコード数、最終同期時刻を確認できます。 接続された URL は、デフォルトで1日1回更新されます。サイトの **設定** → **接続**. {% endstep %} {% step %} #### レコードの使い方を選択する 各接続ごとに、そのレコードを検索や GitBook Assistant に表示するかどうか、また GitBook の変更リクエスト生成に役立てるかどうかを選べます。 また、接続の検索順位を調整して、レコードを優先表示または優先度を下げることもできます。 {% endstep %} {% endstepper %} ### 接続設定 接続を編集すると、次のオプションを設定できます。 #### ラベル 使用 **ラベル** 接続にわかりやすい名前を付ける これにより、特に複数のリポジトリ、ウェブサイト、チャンネルを接続している場合に、接続一覧でソースを識別しやすくなります。 #### 変更リクエストを自動生成 {% hint style="warning" %} 変更リクエストの自動生成は、現在早期アクセス段階です。 以下を参照 [ドキュメントの自動改善](/docs/documentation/ja-gitbook-documentation/gitbook-agent/automatic-docs-improvements.md) アクセス申請に関する情報はこちら {% endhint %} をオンにします **変更リクエストを自動生成** GitBook が接続のレコードから学習し、ドキュメント更新を提案できるようにする GitBook はこれらのレコードを使って、チームが確認できる提案変更付きの変更リクエストを作成できます。 #### 検索 / Assistant に公開 をオンにします **検索 / Assistant に公開** この接続のレコードを、訪問者が検索でき、質問への回答に利用できるようにする これにより、接続されたコンテンツはサイトの AI 搭載検索体験や GitBook Assistant の応答に表示されるようになります。 {% hint style="warning" %} 有効にすると **検索 / Assistant に公開** その接続のレコードが、サイトにアクセスできるすべての人に利用可能になります。サイトが外部共有されている場合は外部訪問者も含まれます。 {% endhint %} #### 検索順位のブースト 使用 **検索順位のブースト** 接続のレコードを検索で優先表示または優先度を下げる このソースをより頻繁に表示したい場合は値を上げます。主要ドキュメントより重みを下げたい場合は値を下げます。 ### コネクタの詳細 このセクションのすべてのコネクタは、 [AIアシスタント](/docs/documentation/ja-gitbook-documentation/keno-ai/gitbook-ai-assistant.md)に文脈を提供できます。GitBook Agent は解決済みのレコードを使って [コンテンツの不足箇所](/docs/documentation/ja-gitbook-documentation/gitbook-agent/automatic-docs-improvements.md) を特定し、ドキュメント更新を提案できます。 #### Intercom GitBook は、人間または AI のサポートエージェントから少なくとも1件の返信がある解決済みの会話をインデックスします。未解決、未解決のままの会話、またはスパム会話はインデックスしません。 Intercom を接続するには、会話への読み取りアクセス権を持つ API キーを使用してください。スコープと有効期限はご自身で管理できます。 #### Zendesk GitBook は、人間または AI のサポートエージェントから少なくとも1件の返信がある解決済みの会話をインデックスします。未解決、未解決のままの会話、またはスパム会話はインデックスしません。 Zendesk を接続するには、次のような Zendesk のサブドメインを入力してください。 `gitbook.zendesk.com`。また、会話への読み取りアクセス権を持つ API キーも必要です。スコープと有効期限はご自身で管理できます。 #### Pylon GitBook は、人間または AI のサポートエージェントから少なくとも1件の返信がある解決済みの会話をインデックスします。未解決、未解決のままの会話、またはスパム会話はインデックスしません。 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 が取得するレコードを制限できますか？ コネクタ固有の要件とインデックスされるレコードは、以下に記載されています [コネクタの詳細](#connector-details).
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/keno-ai/connections.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.