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

# 接続

外部ソースを AI Assistant と GitBook Agent に接続できます

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

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

サイトのサイドバーで、 **Settings → Connections**.

### 利用可能な接続

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

* 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 で **Settings** → **チャンネル** → **詳細設定**.

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

チャンネル URL に `/channel/`の後にある部分をコピーします `/channel/`.
{% endhint %}

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

{% step %}

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

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

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

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

{% step %}

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

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

接続の検索順位も調整して、レコードを優先表示または非優先表示にできます。
{% endstep %}
{% endstepper %}

### 接続を確認する

「接続」ページは3つの部分で構成されています。 **ソースを接続** してコネクタを追加し、 **接続** て既存の接続を管理し、 **レコード** でGitBookが取り込んだデータを閲覧できます。

#### 接続テーブル

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

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

#### レコード

「 **レコード** 」リストには、GitBookがすべての接続から取り込んだ個々の項目が新しい順に表示されます。各レコードには、タイトル、接続元のコネクタ、GitBookによる処理日時、元の項目へのリンクが記載されています。

大規模なサイトではレコードが数千件に達するため、リストはページ分割されています。 **検索 / アシスタントに公開**をオンにする前に、期待どおりの情報がソースから取り込まれているか確認するために使いましょう。たとえば、商品ページが必要なのにウェブサイト接続からブログ記事が返される場合、まずここで確認できます。

### 接続設定

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

#### ラベル

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

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

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

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

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

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

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

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

有効にする **検索／アシスタントに公開** すると、この接続の記録が訪問者の検索対象となり、質問への回答に利用できるようになります。

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

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

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

検索ランキングのブースト **検索ランキングのブースト** を使って、検索でその接続元のレコードを優先または非優先にできます。

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

### コネクタの詳細

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

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

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

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

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

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

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

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

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

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

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

#### FAQ

<details>

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

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

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

その後、サードパーティのLLMを使用して、レコードに対して第2のPII処理を行います。これはZDR準拠の保存なしリクエストであり、当社の第三者のサーバーには保存されず、いかなる学習にも使用されません。

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

</details>

<details>

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

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

また、変更リクエストの作成やユーザーからの質問への回答の際には、マスキング済みのレコード内容を第三者プロバイダーで使用します。

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

</details>

<details>

<summary>GitBookは、自社または第三者を通じて、いかなるモデルの学習にもデータを使用しますか？</summary>

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

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