> 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/gitbook-agent/channels.md).

# チャネル

{% hint style="warning" %}

#### チャンネルは現在、早期アクセス中です

チャンネルへのアクセスを段階的に展開しています。以下の機能の進捗については、今後の更新をお待ちください。
{% endhint %}

{% hint style="info" %}
この機能は〜で利用できます [アルティメットサイトプラン](https://www.gitbook.com/pricing).
{% endhint %}

チャンネルは [GitBook Assistant](/docs/documentation/ja-gitbook-documentation/ai-to/gitbook-ai-assistant.md) と [GitBook Agent](/docs/documentation/ja-gitbook-documentation/gitbook-agent/what-is-gitbook-agent.md) を、チームがすでに使っているツールに組み込みます。接続すると、チームは `@GitBook` を Slack、GitHub、または Linear でメンションして、質問をしたり、変更リクエストを開いたり、既存のワークフローを離れずにドキュメントを最新に保ったりできます。

チャンネルを追加すると、そのツール内で GitBook をどのように表示するかを選べます。各設定は次の 2 つのモードのいずれかで動作します。

**サポートエージェント：** GitBook Assistant は、チャンネル上でチームや訪問者からの質問に直接答えます。質問すると、ドキュメントから取得した回答が返ってきます。Slack では、これらの返信内の引用は、参照しているドキュメントの公開サイト URL にリンクします。たとえば、引用付きの回答は、あなたのドキュメントサイトではなく `app.gitbook.com`.

**コラボレーター：** GitBook Agent がチームメイトとして参加します。メンションすると `@GitBook` 変更リクエストを開いたり、編集を依頼したり、そのツールで起きていることとドキュメントを同期させたりできます。Slack では、メッセージは `app.gitbook.com` 内部のワークフローの文脈、たとえば変更リクエストや下書きコンテンツを参照している場合にリンクできます。Agent がチャンネルから変更リクエストを作成すると、元のスレッド、Issue、またはプルリクエストに自動的にリンクされます。

チャンネルごとに複数の設定を運用できます。たとえば、顧客向けの Slack チャンネルではサポートエージェントモード、ドキュメントチーム向けの別のチャンネルではコラボレーターモードを使う、といった形です。

チャンネルを追加するには、サイトの **設定** を開き、 **チャンネル**.

サポートの質問、バグ報告、製品フィードバックが Slack、GitHub、Linear から始まり、GitBook にその場で応答してほしいときに Channels を使います。

{% hint style="info" %}

#### 自分のウェブサイトや製品に GitBook Assistant を埋め込みたいですか？

次へ進んで [製品に埋め込む](/docs/documentation/ja-gitbook-documentation/docs-site/embedding.md) GitBook Assistant の埋め込み方法を確認してください。
{% endhint %}

<figure><img src="/files/84876a785a0aa8560c8161bbc57f4cbe7ee81287" alt=""><figcaption></figcaption></figure>

### 利用可能なチャンネル

<table data-view="cards"><thead><tr><th></th><th><select><option value="mjZVekTsgGQo" label="進行中" color="blue"></option><option value="exlMMXLVjkth" label="予定" color="blue"></option><option value="WK4vEyJjJM8h" label="利用可能" color="blue"></option></select></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Slack</strong></td><td><span data-option="WK4vEyJjJM8h">利用可能</span></td><td></td><td></td></tr><tr><td><strong>Linear</strong></td><td><span data-option="WK4vEyJjJM8h">利用可能</span></td><td></td><td></td></tr><tr><td><strong>GitHub</strong></td><td><span data-option="WK4vEyJjJM8h">利用可能</span></td><td></td><td></td></tr></tbody></table>

### 近日公開

<table data-view="cards"><thead><tr><th></th><th><select><option value="mjZVekTsgGQo" label="進行中" color="blue"></option><option value="exlMMXLVjkth" label="予定" color="blue"></option><option value="WK4vEyJjJM8h" label="利用可能" color="blue"></option></select></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Discord</strong></td><td><span data-option="exlMMXLVjkth">予定</span></td><td></td><td></td></tr><tr><td><strong>Intercom</strong></td><td><span data-option="exlMMXLVjkth">予定</span></td><td></td><td></td></tr><tr><td><strong>Microsoft Teams</strong></td><td><span data-option="exlMMXLVjkth">予定</span></td><td></td><td></td></tr><tr><td><strong>Google Chat</strong></td><td><span data-option="exlMMXLVjkth">予定</span></td><td></td><td></td></tr><tr><td><strong>チャンネルをリクエストする</strong></td><td></td><td><i class="fa-arrow-up-right-from-square">:arrow-up-right-from-square:</i></td><td><a href="https://github.com/orgs/GitbookIO/discussions/new?category=feature-requests">https://github.com/orgs/GitbookIO/discussions/new?category=feature-requests</a></td></tr></tbody></table>

### 概要

チャンネルは GitBook を外部のワークフローに接続します。

これにより、次のことができます。

* 元の会話から離れずに質問に答えられます。
* 既存のドキュメントの文脈をサポートや製品のワークフローに持ち込めます。
* 重要な会話を [GitBook Agent](/docs/documentation/ja-gitbook-documentation/gitbook-agent/what-is-gitbook-agent.md).

会話は GitBook の外で始まっても、回答や次の対応をドキュメントのプロセスに入れたいときに Channels を使います。

### 対応プラットフォーム

現在、チャンネルは次のプラットフォームをサポートしています。

* **Slack** 会話やサポートスレッド向けです。
* **GitHub** Issue、プルリクエストの文脈、ディスカッションのワークフロー向けです。
* **Linear** Issue 管理や製品フィードバックのワークフロー向けです。

各プラットフォームは同じコアモデルを使用します。

GitBook は接続されたプラットフォームから対応イベントを受け取り、ナレッジから文脈を集め、次のいずれかで応答します： [GitBook Assistant](/docs/documentation/ja-gitbook-documentation/ai-to/gitbook-ai-assistant.md) または [GitBook Agent](/docs/documentation/ja-gitbook-documentation/gitbook-agent/what-is-gitbook-agent.md).

### ロールと権限

チャンネルは 2 つのロールをサポートします。

* **コラボレーター** — 変更を行えます。
* **サポートエージェント** — 読み取り専用の情報を提供します。

チャンネルに何をさせる必要があるかに応じて、ロールを選んでください。

#### コラボレーター

使う **コラボレーター** チャンネルが会話をドキュメント作業に変えるのを手伝う必要があるときに。

コラボレーターのチャンネルでは、GitBook Agent を使って、変更リクエストの作成や進行など、GitBook 内のドキュメント作業を支援できます。

#### サポートエージェント

使う **サポートエージェント** チャンネルが質問に答えるだけでよいときに。

サポートエージェントのチャンネルは、既存のドキュメントと接続されたナレッジを使って、読み取り専用の文脈で返信します。コンテンツの変更は行いません。

### 仕組み

チャンネルは、接続されたプラットフォームからの着信イベントを処理します。

着信イベントには、Slack、GitHub、Linear からの新しいメッセージ、メンション、Issue 更新、その他の対応アクティビティが含まれます。

GitBook はそれらのイベントを 4 つのステップで処理します。

{% stepper %}
{% step %}

### イベントを受信する

接続されたプラットフォームが、インストールしたチャンネル経由で対応イベントを GitBook に送信します。
{% endstep %}

{% step %}

### 文脈を収集する

GitBook は関連するドキュメントの文脈と、サイトで利用可能なその他のナレッジを参照します。
{% endstep %}

{% step %}

### チャンネルのロールを適用する

チャンネルが **サポートエージェント**場合、GitBook は読み取り専用の情報を返します。

チャンネルが **コラボレーター**場合、GitBook は GitBook Agent を通じて会話をドキュメント作業にも変換できます。
{% endstep %}

{% step %}

### 元のツールで返信する

応答は Slack、GitHub、Linear に戻って表示されるため、ワークフローを 1 か所に保てます。
{% endstep %}
{% endstepper %}

{% hint style="info" %}
正確なイベントの対応範囲は、プラットフォームと早期アクセスの展開状況によって異なります。ワークスペースでまだトリガーが利用できない場合、それはまだ公開文書化されていません。
{% endhint %}

### インストールと認証

チャンネルをインストールするには、サイトのダッシュボードを開き、次を選択します **設定** → **チャンネル**.

その後、接続したいプラットフォームを選択します。

各プラットフォームでは OAuth またはアプリのインストールフローを使用します。GitBook からプラットフォームに移動し、アクセスを承認すると、GitBook に戻ってセットアップを完了します。

{% hint style="warning" %}
プラットフォーム固有の権限スコープや管理者要件は、まだ十分に文書化されていません。

アクセスを承認する前に、認可画面をよく確認してください。
{% endhint %}

{% tabs %}
{% tab title="Slack" %}
{% stepper %}
{% step %}

### インストールを開始する

で **設定** → **チャンネル**、次を選択 **Slack**.
{% endstep %}

{% step %}

### Slack を承認

必要に応じて Slack にサインインします。

その後、チャンネルをインストールする Slack ワークスペースを選び、要求されたアクセスを承認します。
{% endstep %}

{% step %}

### GitBook でセットアップを完了

Slack から戻ったら、GitBook でチャンネル設定を完了します。

チャンネルで使用するロールを選択し、設定を保存します。
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="GitHub" %}
{% stepper %}
{% step %}

### インストールを開始する

で **設定** → **チャンネル**、次を選択 **GitHub**.
{% endstep %}

{% step %}

### GitHub を承認

必要に応じて GitHub にサインインします。

その後、GitBook アプリをインストールする個人アカウントまたは organization を選び、要求されたアクセスを承認します。
{% endstep %}

{% step %}

### GitBook でセットアップを完了

GitHub から戻ったら、GitBook でチャンネル設定を完了します。

チャンネルで使用するロールを選択し、設定を保存します。
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Linear" %}
{% stepper %}
{% step %}

### インストールを開始する

で **設定** → **チャンネル**、次を選択 **Linear**.
{% endstep %}

{% step %}

### Linear を承認

必要に応じて Linear にサインインします。

その後、接続したい Linear ワークスペースを選び、要求されたアクセスを承認します。
{% endstep %}

{% step %}

### GitBook でセットアップを完了

Linear から戻ったら、GitBook でチャンネル設定を完了します。

チャンネルで使用するロールを選択し、設定を保存します。
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}

### フィードバックとリアクション

リアクションを使うと、チームはチャンネルの返信にすばやくフィードバックできます。

返信が役に立ったかどうかを示したいときに、リアクションを使います。

そのフィードバックは、実際のワークフローでどの返信がうまく機能しているかを GitBook が理解するのに役立ちます。

{% hint style="info" %}
正確なリアクションの対応付けはまだ文書化されておらず、早期アクセス期間中はプラットフォームごとに異なる場合があります。
{% endhint %}


---

# 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/gitbook-agent/channels.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.