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

Channelsがもたらす [AI アシスタント](/docs/documentation/ja-gitbook-documentation/ai-for-your-readers/gitbook-ai-assistant.md) と [GitBook エージェント](/docs/documentation/ja-gitbook-documentation/gitbook-jento/overview.md) チームがすでに使っているツールに組み込まれます。接続後、チームは〜に言及できます `@GitBook` Slack、GitHub、またはLinearで、質問をしたり、変更リクエストを開いたり、ドキュメントを最新に保ったりできます。既存のワークフローから離れる必要はありません。

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

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

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

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

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

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

{% hint style="info" %}

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

こちらへ [製品に埋め込む](/docs/documentation/ja-gitbook-documentation/publish/embedding.md) AIアシスタントの埋め込み方法を確認してください。
{% 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&amp;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><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 エージェント](/docs/documentation/ja-gitbook-documentation/gitbook-jento/overview.md).

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

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

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

* **Slack** 会話やサポートスレッド向け。
* **GitHub** issue、プルリクエストの文脈、ディスカッションワークフロー向け。
* **Linear** issue追跡と製品フィードバックのワークフロー向け。
* **Jira** チケットをドキュメント更新に変えるため。

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

GitBookは接続されたプラットフォームから対応イベントを受け取り、ナレッジから文脈を収集し、次のいずれかを通じて応答します： [AI アシスタント](/docs/documentation/ja-gitbook-documentation/ai-for-your-readers/gitbook-ai-assistant.md) または [GitBook エージェント](/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は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でチャンネル設定を完了します。

チャンネルで使用する役割を選び、設定を保存します。
{% 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 %}

{% 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に扱わせたいプロジェクトを選びます。選択を空にすると、接続されたアカウントからアクセス可能なすべてのプロジェクトが含まれます。ラベルが付いたissueのみ `gitbook` ドキュメント作業を開始します。

設定する **Jira status when merged** です。 **完了**、またはプロジェクトのワークフローにおける同等のステータスに設定すると、変更リクエストのマージでチケットも完了します。クリック **保存**。GitBookは「Jiraの設定を保存しました」というメッセージで確認します。
{% endstep %}
{% endstepper %}

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

{% stepper %}
{% step %}

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

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

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

{% step %}

### 〜を追加する `gitbook` label

追加 `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.