> 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/ai-to/connections.md).

# 接続

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

接続されたコンテンツは、次の場所に表示される場合があります [AI検索](/docs/documentation/ja-gitbook-documentation/docs-site/ai-search.md) と [GitBook Assistant](/docs/documentation/ja-gitbook-documentation/ai-to/gitbook-ai-assistant.md)。一部の接続は、GitBook が変更リクエストを生成するのにも役立ちます。

接続を追加するには、サイトの **設定** を開き、 **接続**.

<figure><img src="/files/9b453463368ca37e9356c86d7be86c5d5a013db9" alt=""><figcaption></figcaption></figure>

### 利用可能な接続

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

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4>Intercom</h4></td><td><a href="/pages/b602ddf106f9f34b6ac8244f63f46c0cf75c4538">/pages/b602ddf106f9f34b6ac8244f63f46c0cf75c4538</a></td></tr><tr><td><h4>Zendesk</h4></td><td><a href="/pages/4367e0c985970cd84931d85dd1f7b89f12307881">/pages/4367e0c985970cd84931d85dd1f7b89f12307881</a></td></tr><tr><td><h4>Freshdesk</h4></td><td></td></tr><tr><td><h4>Front</h4></td><td></td></tr><tr><td><h4>HubSpot</h4></td><td></td></tr><tr><td><h4>Zoho Desk</h4></td><td></td></tr><tr><td><h4>Pylon</h4></td><td><a href="/pages/152228ad7c40a844b0feae4cd62085936c9d47e0">/pages/152228ad7c40a844b0feae4cd62085936c9d47e0</a></td></tr><tr><td><h4>GitHub Discussions</h4></td><td><a href="/pages/ab2a8994730d22eb0d119f1a68797c2416647176">/pages/ab2a8994730d22eb0d119f1a68797c2416647176</a></td></tr><tr><td><h4>GitHub Issues</h4></td><td><a href="/pages/a82bb5e38fa3937eccaeed1c68342e8ddb5e6ce2">/pages/a82bb5e38fa3937eccaeed1c68342e8ddb5e6ce2</a></td></tr><tr><td><h4>YouTube</h4></td><td></td></tr><tr><td><h4>Webサイト</h4></td><td></td></tr><tr><td><h4>MCPサーバー</h4></td><td></td></tr></tbody></table>

### 接続の仕組み

{% stepper %}
{% step %}

#### ソースを接続する

ソースの種類を選択します。次に、それを認可するか、GitBook にインポートしてほしい URL を入力します。

{% hint style="info" %}
YouTube を接続する場合は、チャンネル名ではなくチャンネル ID を入力してください。

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

YouTube Studio で、を開き **設定** → **チャンネル** → **詳細設定**.

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

チャンネル URL に `/channel/`が含まれている場合は、その後ろの部分をコピーします `/channel/`.
{% endhint %}

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

{% step %}

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

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

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

接続済み URL は既定で 1 日に 1 回更新されます。サイトの **設定** → **接続**.
{% endstep %}

{% step %}

#### レコードの使用方法を選択

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

また、接続の検索順位を調整して、レコードの優先度を上げたり下げたりできます。
{% endstep %}
{% endstepper %}

### 接続設定

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

#### ラベル

使用 **ラベル** を使って、接続にわかりやすい名前を付けます。

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

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

{% 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 %}

#### 検索順位ブースト

使用 **検索順位ブースト** 検索で接続のレコードの優先度を上げたり下げたりできます。

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

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

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

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

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

レコードは、ソースが接続されたままである限り保持します。接続を削除すると、保存されたレコードはすべて削除されます。これらのレコードをコンテキストとして生成されたコンテンツは削除せず、保存済みの AI 会話ログからレコードの内容を削除することもありません。

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

各コネクタの詳細ページで、コネクタに関する詳細情報を確認できます。

#### よくある質問

<details>

<summary>PII に関するポリシーは？</summary>

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

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

次に、サードパーティの LLM を使用した 2 段階目の PII 処理にレコードを通します。これは ZDR 準拠のストアしないリクエストで、サードパーティのサーバーに保存されず、トレーニングにも使用されません。

この前処理の間、PII が数分間サーバー上に存在する可能性がありますが、保存するのは後処理後のレコードのみです。

</details>

<details>

<summary>データを第三者に送信しますか？</summary>

初期の社内 PII 削除が完了した後、PII を削除するために第三者を使用しています。

変更リクエストを作成したりユーザーの質問に回答したりする際、削除済みレコードの内容を第三者プロバイダーでも使用します。

たとえば、GitBook Agent でコンテンツを作成する際、エージェントは外部レコードの内容を追加コンテキストとして含めることがあります。

</details>

<details>

<summary>GitBook は、自身または第三者を通じて、モデル学習にデータを使用しますか</summary>

いいえ、レコードデータを学習に使用しません。また、第三者プロバイダーにも同様でないことを確認しています。

</details>

<details>

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

各ソースで設定できる内容については、各コネクタの詳細ページをご覧ください。

* [Intercom](/docs/documentation/ja-gitbook-documentation/ai-to/connections/intercom.md)
* [Zendesk](/docs/documentation/ja-gitbook-documentation/ai-to/connections/zendesk.md)
* Freshdesk
* Front
* HubSpot
* Zoho Desk
* [Pylon](/docs/documentation/ja-gitbook-documentation/ai-to/connections/pylon.md)

</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/ai-to/connections.md?ask=<question>&goal=<endgoal>
```

`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.
