# 接続

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

接続されたコンテンツは [AI 検索](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/ja-gitbook-documentation/docs-site/ai-search) 、 [GitBook Assistant](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/ja-gitbook-documentation/ai-to/gitbook-ai-assistant)に表示できます。一部の接続では、GitBook が変更リクエストを生成するのにも役立ちます。

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

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FRJwCRgQ7bEF45BpqdXOQ%2F25_03_30_connections%402x.png?alt=media&#x26;token=3bbf0d47-e72a-43a3-ae1b-79e91b6aa180" alt=""><figcaption></figcaption></figure>

### 接続の仕組み

{% 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" %}
変更リクエストの自動生成は現在早期アクセスです。

参照 [agent-audit](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-agent/agent-audit "mention") アクセス申請に関する情報
{% endhint %}

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

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

#### 検索 / Assistantに公開

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

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

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

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

使うもの **検索ランキングのブースト** 検索で接続のレコードの優先度を上げたり下げたりします。

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