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

# チャンネル

Slack、GitHub、Linear、Jira で AI アシスタントと GitBook Agent を使用する

{% hint style="warning" %}

#### Channelsは早期アクセス中です

Channelsへのアクセスを段階的に展開しています。以下の機能の進捗もお待ちください。
{% endhint %}

チャネルを通じて [AI Assistant](https://gitbook.com/docs/documentation/ja-gitbook-documentation/ai-for-your-readers/gitbook-ai-assistant.md) と [GitBook Agent](https://gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-jento/overview.md) をチームがすでに使用しているツールに取り込めます。接続すると、チームはSlack、GitHub、Linearで `@GitBook` にメンションして質問したり、変更リクエストを作成したり、ドキュメントを最新の状態に保ったりできます。既存のワークフローから離れる必要はありません。

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

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

**コラボレーター：** GitBook Agentはチームメイトとして参加します。 `@GitBook` にメンションすると、変更リクエストを作成したり、編集を依頼したり、そのツールでの進捗に合わせてドキュメントを最新の状態に保ったりできます。Slackでは、変更リクエストや下書きコンテンツなど、内部ワークフローの情報を参照するメッセージから `app.gitbook.com` にリンクできます。GitBook Agentがチャネルから変更リクエストを作成すると、元のスレッド、課題、またはプルリクエストに自動的にリンクします。

チャネルごとに複数の構成を実行できます。たとえば、顧客対応用の Slack チャネルではサポート担当者モードを使い、ドキュメントチーム向けの別のチャネルではコラボレーター モードを使うことができます。

チャンネルを追加するには、サイトの **拡張機能 → チャンネル**.

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

{% hint style="info" %}

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

AI Assistantの埋め込み方法については、 [製品に埋め込む](https://gitbook.com/docs/documentation/ja-gitbook-documentation/publish/embedding.md) をご覧ください。
{% endhint %}

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-64be9b2e2b4ae9ab530fa6eb244a3890f0fb36e4%2F26_05_01_channels%402x.png?alt=media" 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><tr><td><strong>Jira</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](https://gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-jento/overview.md).

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

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

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

* **Slack** 会話やサポートスレッドに活用できます。
* **GitHub** 課題、プルリクエストのコンテキスト、ディスカッションのワークフローに活用できます。
* **Linear** 課題管理や製品へのフィードバックのワークフローに活用できます。
* **Jira** チケットをドキュメントの更新につなげるのに活用できます。

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

GitBookは接続されたプラットフォームから対応イベントを受け取り、ナレッジから関連情報を収集して、 [AI Assistant](https://gitbook.com/docs/documentation/ja-gitbook-documentation/ai-for-your-readers/gitbook-ai-assistant.md) または [GitBook Agent](https://gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-jento/overview.md).

### 役割と権限

Channelsは2つの役割をサポートしています：

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

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

#### コラボレーター

会話をドキュメント作成の作業につなげる必要があるチャネルでは、 **コラボレーター** を使用してください。

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

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

質問への回答だけが必要なチャネルでは、 **サポートエージェント** を使用してください。

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

### 仕組み

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

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

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

{% stepper %}
{% step %}

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

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

{% step %}

### 文脈を収集する

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

{% step %}

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

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

チャネルが **コラボレーター**。GitBook Agent を使えば、会話をドキュメント作成の作業に変換することもできます。
{% endstep %}

{% step %}

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

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

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

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

チャンネルをインストールするには、サイトのダッシュボードを開き、 **拡張機能 → チャンネル**.

を選択します。

次に、接続したいプラットフォームを選びます。

{% hint style="warning" %}
Slack、GitHub、LinearではOAuthまたはアプリのインストールフローを使用します。GitBookからプラットフォームへ移動し、アクセスを承認すると、GitBookに戻ってセットアップを完了します。

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

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

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

「 **拡張機能 → チャンネル**で、 **Slack**.
{% endstep %}

{% step %}

### Slackを認可する

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

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

{% step %}

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

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

「 **設定を追加**」をクリックします。「 **ロールを選択** 」ダイアログで、チャンネルに使用するロールを選択し、「 **チャンネルを作成**:

* **サポートエージェント**：ユーザーからの質問に回答し、サポートを提供します。Slack のデフォルトです。
* **コラボレーター**：チームと協力してドキュメントを管理し、改善案を提案します。
  {% endstep %}
  {% endstepper %}
  {% endtab %}

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

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

「 **拡張機能 → チャンネル**で、 **GitHub**.
{% endstep %}

{% step %}

### GitHubを認可する

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

次に、GitBookアプリをインストールしたい個人アカウントまたは組織を選び、要求されたアクセスを承認します。
{% endstep %}

{% step %}

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

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

「 **設定を追加**」をクリックします。「 **ロールを選択** 」ダイアログで、チャンネルに使用するロールを選択し、「 **チャンネルを作成**:

* **サポートエージェント**：ユーザーからの質問に回答し、サポートを提供します。
* **コラボレーター**：チームと協力してドキュメントを管理し、改善案を提案します。GitHub のデフォルトです。
  {% endstep %}
  {% endstepper %}
  {% endtab %}

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

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

「 **拡張機能 → チャンネル**で、 **Linear**.
{% endstep %}

{% step %}

### Linearを認可する

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

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

{% step %}

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

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

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

{% tab title="Jira" %}
Jira を GitBook サイトに接続し、チケットに `gitbook` ラベルを追加します。GitBook Agent はそのチケットを使って変更リクエストの草案を作成し、チームがレビューできるようにします。

#### 始める前に

以下が必要です：

* Channelsが利用可能で、GitBook Agentが有効かつ一時停止されていない、GitBookサイトへの管理者アクセス。
* Jira Cloudサイト、Atlassianアカウントのメールアドレス、そのアカウント用のAPIトークン。アカウントには、使用したいプロジェクトへのアクセス権と、issueにコメントしたりリンクしたりする権限が必要です。

#### Jiraを接続

{% stepper %}
{% step %}

### セットアップを開始

サイトの **拡張機能 → チャンネル**の「 **Jira**」の下にある「 **設定を追加**.

Jira では、チームがドキュメントを維持できるように **コラボレーター** ロールを使用します。
{% endstep %}

{% step %}

### Jiraアカウントを接続

次の詳細を入力してください：

* **Jira サイトの URL:** Jira Cloud の URL（例:） `https://your-site.atlassian.net`.
* **アカウントのメールアドレス:** トークンを作成した Atlassian アカウントのメールアドレス。
* **Jira API トークン:** [Atlassian で API トークンを作成し](https://id.atlassian.com/manage-profile/security/api-tokens)、ここに貼り付けます。

\[ **Jira に接続**] をクリックします。接続に成功すると、GitBook に利用可能なプロジェクトが表示されます。
{% endstep %}

{% step %}

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

GitBook に処理させるプロジェクトを選択します。何も選択しない場合、接続アカウントがアクセスできるすべてのプロジェクトが対象になります。ラベルが `gitbook` の課題のみがドキュメント作成を開始します。

「 **マージ時の Jira ステータス** 」を **完了**、またはプロジェクトのワークフローで同等のステータスに設定すると、変更リクエストのマージ時にチケットも完了します。\[ **保存**] をクリックします。GitBook に「Jira configuration saved」というメッセージが表示されます。
{% endstep %}
{% endstepper %}

#### チケットから変更リクエストを作成する

{% stepper %}
{% step %}

### ドキュメント変更を説明する

設定で対象となっているプロジェクトのいずれかでJiraチケットを開くか作成します。わかりやすいタイトルを付け、ドキュメントに何を書くべきかを説明します。

たとえば、タイトルに「APIキーのローテーションを文書化する」を使い、ローテーション手順、実行できる人、古いキーに何が起こるかを含めます。
{% endstep %}

{% step %}

### 次を追加します `gitbook` ラベル

追加 `gitbook` をチケットのラベルに追加して保存します。

GitBook Agentはチケットのタイトルと説明から変更リクエストの下書きを作成し、Jiraにコメントと変更リクエストへのリンクを追加します。
{% endstep %}

{% step %}

### 下書きを確認する

JiraのリンクをたどってGitBookで変更リクエストを開きます。提案された変更を確認し、必要なら編集し、ドキュメントの準備ができたらマージします。
{% endstep %}
{% endstepper %}

#### 任意：Jiraから追加の編集を依頼する

変更リクエストが開いている間に、次の内容を含むコメントを追加します。 `@gitbook` と、希望する変更を記述します。例:

> @gitbook 古いAPIキーがいつ使えなくなるかを説明する注記を追加してください。

GitBook Agentはリンクされた下書きを更新し、Jiraに更新コメントを投稿します。チケットのタイトルや説明を編集するだけでは、追加の編集依頼にはなりません。
{% 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-jento/channels.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
