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

チャンネルがもたらすのは [GitBook Assistant](/docs/documentation/ja-gitbook-documentation/notameno-ai/gitbook-ai-assistant.md) 、 [GitBook Agent](/docs/documentation/ja-gitbook-documentation/gitbook-agent/overview.md) チームがすでに使っているツール内へ。接続すると、チームは次のようにメンションできます `@GitBook` Slack、GitHub、または Linear で、質問したり、変更リクエストを開いたり、ドキュメントを最新の状態に保ったりできます。既存のワークフローを離れる必要はありません。

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

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

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

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

チャンネルを追加するには、サイトの **設定** を開き、次をクリックします **チャネル**.

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

{% hint style="info" %}

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

次へ移動します [製品に埋め込む](/docs/documentation/ja-gitbook-documentation/gong-kai/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>

### 概要

Channels は GitBook を外部ワークフローに接続します。

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

* 元の会話を離れずに質問に答える。
* 既存のドキュメントのコンテキストをサポートや製品のワークフローに持ち込む。
* 重要な会話を次の機能でドキュメント更新に変える [GitBook Agent](/docs/documentation/ja-gitbook-documentation/gitbook-agent/overview.md).

会話が GitBook の外で始まっても、回答やフォローアップをドキュメント作成プロセスに含めたいときに Channels を使います。

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

Channels は現在、次のプラットフォームをサポートしています:

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

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

GitBook は接続先プラットフォームから対応イベントを受け取り、ナレッジからコンテキストを収集し、次のいずれかで応答します [GitBook Assistant](/docs/documentation/ja-gitbook-documentation/notameno-ai/gitbook-ai-assistant.md) または [GitBook Agent](/docs/documentation/ja-gitbook-documentation/gitbook-agent/overview.md).

### 役割と権限

Channels には 2 つの役割があります:

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

チャンネルで何を行う必要があるかに応じて役割を選択してください。

#### コラボレーター

使用する **コラボレーター** チャンネルが会話をドキュメント作業へ変換するのを支援する必要があるとき。

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

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

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

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

### 仕組み

Channels は接続されたプラットフォームからの受信イベントを処理します。

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

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

{% stepper %}
{% step %}

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

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

{% step %}

### コンテキストを収集する

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

{% step %}

### チャンネルの役割を適用する

チャンネルが **サポートエージェント**の場合、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 アプリをインストールしたい個人アカウントまたは組織を選び、要求されたアクセスを承認します。
{% 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.