# 接続

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

接続されたコンテンツは [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>

### 接続の仕組み

{% 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/agent-audit.md) アクセス申請に関する情報
{% endhint %}

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

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

#### 検索 / Assistantに公開

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

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

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

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

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

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


---

# Agent Instructions: 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:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/ai-to/connections.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.