> 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-for-your-readers/connections.md).

# 接続

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

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

接続されたコンテンツは [AI アシスタント](/docs/documentation/ja-gitbook-documentation/ai-for-your-readers/gitbook-ai-assistant.md)、そのため、訪問者はドキュメントだけでなく、公開しているすべての内容から得られる回答を受け取れます。一部の接続は、GitBook が変更リクエストを生成し、識別するのにも役立ちます [コンテンツの不足箇所](/docs/documentation/ja-gitbook-documentation/analytics/content-gaps.md)。MCP サーバー接続を使うと、訪問者がドキュメント内からタスクを実行できるようにすることもできます。

サイトのサイドバーで、次へ移動します **設定 → 接続**.

### 利用可能な接続

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

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

### 接続の仕組み

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

### 接続を確認する

［接続］ページは 3 つの部分で構成されています： **ソースを接続する** コネクタを追加するには、 **接続** すでにあるものを管理するには、 **レコード** GitBook が取り込んだ内容を閲覧するには。

#### 接続テーブル

接続された各ソースは 1 行で表示されます：

| 列     | 表示内容                                                      |
| ----- | --------------------------------------------------------- |
| ソース   | 接続元となるコネクタと、その接続先のアカウント、チャンネル、または URL。                    |
| ステータス | 最新の同期が完了したかどうか。                                           |
| レコード  | ソースが提供した項目数。数え方はそのソース固有の単位 — ページ、動画、ディスカッション、会話 — に基づきます。 |
| 検索    | 接続の検索順位ブースト。これは、 **検索 / アシスタントに公開** オフです。                 |
| 最終同期  | 接続が最後に更新されてからの経過時間。                                       |

#### レコード

この **レコード** 一覧には、GitBook がすべての接続から取り込んだ個々の項目が、新しいものから順に表示されます。各レコードには、タイトル、元となったコネクタ、GitBook がそれを処理した日時、および元の項目へのリンクが表示されます。

大規模なサイトではレコードが数千件に達するため、一覧はページ分割されています。ソースが期待どおりの内容を取り込んでいることを確認してから、 **検索 / アシスタントに公開**：商品ページを期待していたのにウェブサイト接続がブログ投稿を返す場合、まずここに表示されます。

### 接続設定

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

#### ラベル

使用 **ラベル** 接続にわかりやすい名前を付けるためのものです。

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

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

{% hint style="warning" %}
変更リクエストの自動生成はベータ版です。

を参照してください [コンテンツのギャップ](/docs/documentation/ja-gitbook-documentation/analytics/content-gaps.md) GitBook がドキュメントの不足をどのように特定するかについては、
{% endhint %}

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

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

#### 検索 / アシスタントに公開

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

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

{% hint style="warning" %}
を有効にすると **検索 / アシスタントに公開** その接続のレコードが、サイトにアクセスできるすべての人に利用可能になります。サイトが外部共有されている場合は、外部訪問者も含みます。
{% endhint %}

#### 検索ランキングのブースト

使用 **検索ランキングのブースト** 検索で、ある接続のレコードを優先表示または非優先表示にするためのものです。

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

### コネクタの詳細

このセクションのすべてのコネクタは、 [AI アシスタント](/docs/documentation/ja-gitbook-documentation/ai-for-your-readers/gitbook-ai-assistant.md)にコンテキストを提供できます。GitBook Agent は解決済みのレコードを使用して [コンテンツの不足箇所](/docs/documentation/ja-gitbook-documentation/analytics/content-gaps.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 は解決済みの issue をインデックス化します。オープン、未解決、またはスパムの会話はインデックス化しません。

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

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

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

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

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

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

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

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

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

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

#### FAQ

<details>

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

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

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

その後、3rd party LLM を使用した 2 段階目の PII 処理を行います。これは ZDR 準拠の保存なしリクエストであり、3rd party のサーバーには保存されず、トレーニングにも使用されません。

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

</details>

<details>

<summary>データを 3rd party に送信しますか?</summary>

最初の内部 PII マスキングが完了した後、3rd party を使用して PII をマスクしています。

また、変更リクエストを作成したりユーザーの質問に応答したりする際、3rd party プロバイダーでマスク済みのレコード内容を使用します。

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

</details>

<details>

<summary>GitBook は、自社でも 3rd party 経由でも、モデル学習にデータを使用しますか</summary>

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

</details>

<details>

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

コネクタ固有の要件とインデックス化されるレコードは、で一覧表示されています [コネクタの詳細](#connector-details).

</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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/ai-for-your-readers/connections.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.