> For the complete documentation index, see [llms.txt](https://gitbook-open-v2-preview.gitbook.workers.dev/url/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-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-agent/channels.md). # チャネル {% hint style="warning" %} #### チャンネルは現在早期アクセス中です チャンネルへのアクセスは少しずつ提供されています。以下の機能の進捗については、続報をお待ちください。 {% endhint %} チャンネルがもたらす [GitBookアシスタント](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/ai-to/gitbook-ai-assistant.md) と [GitBookエージェント](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-agent/what-is-gitbook-agent.md) を、すでに作業が行われているツールに持ち込みます。 チャンネルがもたらす [GitBookアシスタント](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/ai-to/gitbook-ai-assistant.md) と [GitBookエージェント](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-agent/what-is-gitbook-agent.md) を、チームがすでに使っているツールに持ち込みます。接続すると、チームは `@GitBook` をSlack、GitHub、またはLinearでメンションして、質問をしたり、変更リクエストを開いたり、既存のワークフローを離れずにドキュメントを最新に保ったりできます。 チャンネルがもたらす [GitBookアシスタント](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/ai-to/gitbook-ai-assistant.md) と [GitBookエージェント](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-agent/what-is-gitbook-agent.md) を、チームがすでに使っているツールに持ち込みます。接続すると、チームは `@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アシスタントをウェブサイトや製品に埋め込みたいですか？ こちらへ [製品に埋め込む](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/docs-site/embedding.md) GitBookアシスタントの埋め込み方法を確認してください。 {% endhint %}
### 利用可能なチャンネル
Slack利用可能
Linear利用可能
GitHub利用可能
### 近日公開
Discord予定
Intercom予定
Microsoft Teams予定
Google Chat予定
チャンネルをリクエスト:arrow-up-right-from-square:https://github.com/orgs/GitbookIO/discussions/new?category=feature-requests
### 概要 チャンネルはGitBookを外部ワークフローに接続します。 できること: * 元の会話から離れずに質問に答えられます。 * 既存のドキュメントの文脈を、サポートや製品のワークフローに持ち込めます。 * 重要な会話をドキュメント更新に変えるには [GitBookエージェント](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-agent/what-is-gitbook-agent.md). 会話がGitBookの外で始まっていても、答えやフォローアップがドキュメントのプロセスに属する場合にChannelsを使います。 ### 対応プラットフォーム チャンネルは現在、次のプラットフォームをサポートしています: * **Slack** 会話やサポートスレッド向けです。 * **GitHub** Issue、プルリクエストの文脈、ディスカッションのワークフロー向けです。 * **Linear** Issue追跡と製品フィードバックのワークフロー向けです。 各プラットフォームは同じコアモデルを使用します。 GitBookは接続されたプラットフォームからサポート対象のイベントを受け取り、ナレッジからコンテキストを収集し、次のいずれかで応答します [GitBookアシスタント](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/ai-to/gitbook-ai-assistant.md) または [GitBookエージェント](/url/gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-agent/what-is-gitbook-agent.md). ### ロールと権限 チャンネルは次の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 %} --- # 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: ``` GET https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-agent/channels.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.