# チャネル

{% hint style="warning" %}

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

チャンネルへのアクセスは少しずつ提供されています。以下の機能の進捗については、続報をお待ちください。
{% endhint %}

チャンネルがもたらす [GitBookアシスタント](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/ja-gitbook-documentation/ai-to/gitbook-ai-assistant) と [GitBookエージェント](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-agent/what-is-gitbook-agent) を、すでに作業が行われているツールに持ち込みます。

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

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

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

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

**コラボレーター:** GitBookエージェントがチームメイトとして参加します。 `@GitBook` メンションして `app.gitbook.com` 、変更リクエストを開いたり、編集を依頼したり、そのツールで起きていることに合わせてドキュメントを同期したりできます。Slackでは、メッセージは

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

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

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

{% hint style="info" %}

#### GitBookアシスタントをウェブサイトや製品に埋め込みたいですか？

こちらへ [embedding](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/ja-gitbook-documentation/docs-site/embedding "mention") GitBookアシスタントの埋め込み方法を確認してください。
{% endhint %}

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FvdGn4ibGuysRhvoOiAkI%2F26_05_01_channels%402x.png?alt=media&#x26;token=e6cececa-7769-4e66-8f27-2995a822c946" 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エージェント](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-agent/what-is-gitbook-agent).

会話がGitBookの外で始まっていても、答えやフォローアップがドキュメントのプロセスに属する場合にChannelsを使います。

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

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

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

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

GitBookは接続されたプラットフォームからサポート対象のイベントを受け取り、ナレッジからコンテキストを収集し、次のいずれかで応答します [GitBookアシスタント](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/ja-gitbook-documentation/ai-to/gitbook-ai-assistant) または [GitBookエージェント](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-agent/what-is-gitbook-agent).

### ロールと権限

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

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

チャンネルに必要な役割に応じてロールを選択してください。

#### コラボレーター

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

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

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

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

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

### 仕組み

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

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

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

{% stepper %}
{% step %}

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

接続されたプラットフォームは、インストールしたチャンネルを通じて、サポート対象のイベントをGitBookに送信します。
{% endstep %}

{% step %}

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

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

{% step %}

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

チャンネルが **サポートエージェント**サポートエージェントの場合

チャンネルが **コラボレーター**コラボレーターの場合は、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 %}