チャネルの概要と連携
このページでは、外部メッセージチャネルと個人アカウントの連携の関係、および管理者がアプリの設定を完了した後に、ユーザーが自分のチャネルアカウントを認証して連携する方法について説明します。
対象読者：チャネルの設定者と外部チャットプラットフォームの利用者。
検索キーワード：Channel binding、チャンネル連携、チャネル接続、ボット。
1. チャネル連携で解決できること
チャネル連携は、外部チャットプラットフォームのアカウントとAEアカウントを関連付けます。これにより、使い慣れたチャットツールからリクエストを送信し、システムが本人を識別して、権限のあるワークスペースでAgentを使用できます。
- 外部チャットの入口からAgentを使用：毎回AEのページに戻ってリクエストを送信する必要はありません。
- 業務に応じて実行環境を選択：通常のダイレクトメッセージでワークスペースとAgentを選択すると、以降のメッセージでは現在の選択が引き継がれます。
- 設定と利用の役割分担：管理者はチャネルインスタンスの接続と有効化を担当し、利用者は自分のアカウントの連携を担当します。連携によって追加のリソース権限が自動的に付与されることはありません。
同じプラットフォームに複数のチャネルインスタンスが存在する場合があります。操作時はプラットフォームとインスタンス名の両方を確認する必要があり、「Feishu」や「Slack」などのプラットフォーム名だけで連携先を判断しないでください。
2. 連携前の準備とチャネルインスタンスの選択
前提条件：管理者がチャンネル管理で、対象プラットフォームのアプリメッセージチャネルを設定済みであること。アカウント連携は、外部プラットフォームでの本人のアイデンティティを関連付けるためのものです。プラットフォームアプリの設定と個人アカウントの連携は別々のステップです。
対象のチャネルが有効になっていること、正しいAEアカウントでログインしていること、自分の外部プラットフォームアカウントを使用できることを確認してください。新規連携または連携の復元には、利用可能な個人デフォルトスペースがすでに存在している必要もあります。連携操作によってスペースが自動作成・修復されることはありません。
- AEのユーザーメニューを開き、「チャネル連携」に進みます。
- 使用するプラットフォームを展開し、管理者から提供されたチャネルインスタンス名を探します。インスタンスが多い場合は、リストの検索を使用できます。
- 「連携済み」「未連携」「無効」などのステータスを確認してから、対象のインスタンスで連携または管理の操作を行います。
未連携かつ無効化されているインスタンスや、利用可能な連携方式がまだ設定されていないインスタンスは、リストに表示されない場合があります。連携済みのインスタンスは、無効化されていても表示されることがあります。「連携済み」はアイデンティティが関連付けられていることを示すもので、チャネルが現在メッセージを受信・実行できることを示すものではありません。
3. アカウント認証または連携コードによる検証を完了する
対象インスタンスの「連携」をクリックし、実際に表示された認証ウィンドウまたは連携コードのダイアログに従って操作を完了します。利用できる方式はプラットフォームと管理者の設定によって異なり、すべてのチャネルで同じ認証ウィンドウが表示されるわけではありません。
| 方式 | 完了方法 | 利用のヒント |
|---|---|---|
| アカウント認証 | 開いた認証ウィンドウで外部アカウントと権限を確認し、認証を確定したらAEに戻って連携ステータスを確認します。 | Feishu、Lark、Slack、Discordは認証フローを使用します。その他の一部のプラットフォームでも、設定後に認証方式を提供できます。 |
| 連携コードによる検証 | ダイアログに表示された完全な連携コマンドをコピーし、対応するボットまたは接続アカウントとのダイレクトメッセージで送信して、連携が成功するのを待ちます。 | コマンドはプラットフォームによって異なります。WeComでは「绑定 連携コード」、DingTalk、Mattermost、Google Chat、Zoom Team Chat、WhatsAppでは「+bind 連携コード」を使用します。実際に生成されたコマンドをそのままコピーしてください。 |
| Google Chatのファイル認証 | 連携済みでもネイティブファイル送信がまだ認証されていない場合は、「ファイルを認証」をクリックして認証を完了します。未連携の場合は「連携して認証」が表示されることがあります。 | 管理者が対応する認証方式を事前に設定しておく必要があります。アイデンティティの連携とネイティブファイル送信の認証は別の権限です。 |
連携コードは本人の外部アカウントの検証にのみ使用します。他人に転送したり、公開のグループチャットに送信したりしないでください。連携コードの有効期限が切れた場合は、連携をやり直して新しいコマンドを使用してください。完了したら「チャネル連携」に戻り、対象のインスタンスに「連携済み」と表示されていることを確認します。
Google Chatの複数インスタンスに関する注意：同じ会社に複数のGoogle Chatインスタンスがある場合、現在の連携コードのフローでは、メニューで選択したインスタンスに連携されることは保証されません。設定済みのアカウント認証方式を優先して使用してください。連携コードしか使用できない場合は、事前に管理者に対象インスタンスを確認してもらい、連携成功のメッセージだけで連携先を判断しないでください。
4. ダイレクトメッセージでワークスペースとAgentを選択する
以下のコマンドは通常のダイレクトメッセージで使用できます。スペースの選択によって以降のリクエストを実行するワークスペースが決まり、Agentの選択によって使用するアシスタントが決まります。選択内容は現在のチャネル連携に保存され、以降のメッセージにも引き継がれます。次の1件のメッセージだけに適用されるわけではありません。
Feishu、Lark、Discord、DingTalk、WeComの会話コマンドのプレフィックスは「/」、Slack、Mattermost、Google Chat、Zoom Team Chat、WhatsAppは「+」です。連携コードのコマンドは連携ポップアップの表示に従い、ここでの会話コマンドのプレフィックスと混同しないでください。
| 目的 | 「/」プレフィックスのチャネル | 「+」プレフィックスのチャネル |
|---|---|---|
| 選択可能なワークスペースを表示 | /space | +space |
| 名前でワークスペースを選択 | /space 空间名称 | +space 空间名称 |
| 個人デフォルトスペースに戻す | /space default | +space default |
| 選択可能なAgentを表示 | /agent | +agent |
| 名前でAgentを選択 | /agent Agent名称 | +agent Agent名称 |
| 現在のスペースのデフォルトAgentに戻す | /agent default | +agent default |
まずリストを確認してから、完全な名前で選択してください。同じ名前があり一意に特定できない場合は、先に名前を区別する必要があります。代わりにスペースやAgentのIDを使用しないでください。スペースは、アクセス可能な個人スペースまたは現在の会社の共有スペースである必要があり、Agentも表示可能かつ有効である必要があります。実際に実行するには、現在のスペースでの実行権限も必要です。
- 別のスペースに切り替える：切り替え先のスペースで新しい会話が作成され、現在の連携で個別に選択したAgentはクリアされて、切り替え先スペースのデフォルトAgentが使用されます。以前の会話は新しいスペースに移動されません。
- Agentを切り替える：現在の連携のAgent選択が更新され、モデルの実行コンテキストがリセットされます。元のモデルコンテキストがそのまま引き継がれるとは考えないでください。
- キュー待ち、実行中、またはユーザー入力待ちのとき：スペースやAgentは切り替えられません。先に現在の実行を完了または終了してください。
- グループチャット：上記の通常のダイレクトメッセージにおけるスペース選択ルールは適用されません。個人のダイレクトメッセージでの選択を、グループチャット全体の共通設定として扱うことはできません。
5. 連携の管理と権限の範囲
連携解除と再連携
「チャネル連携」で連携済みのインスタンスを探し、連携解除を選択して確認メッセージを確認します。通常、連携解除によって解除されるのは選択したインスタンスに対する本人のアイデンティティの関連付けのみで、管理者が設定したチャネルアプリは削除されません。連携解除に失敗した場合は、エラーメッセージに従って対処してから再試行してください。ダイアログを閉じたことを連携解除の成功と見なさないでください。
Google Chatの現在の制限：連携を解除すると、選択したインスタンスだけでなく、同じ会社における本人のすべてのGoogle Chat連携が解除され、それらの連携に対応するネイティブファイル送信の認証もクリアされます。いずれか1つのインスタンスだけを解除したい場合は、事前に管理者に対応方法を確認してください。
連携を解除した後は、再度検証を完了しないとアイデンティティを識別できません。連携を復元すると個人デフォルトスペースが再び使用され、以前に個別に選択したAgentはクリアされます。別のスペースやAgentが必要な場合は、連携後に選択し直してください。外部アカウントがすでに他のAEユーザーに連携されているというメッセージが表示された場合は、既存の連携を処理してから再試行してください。
連携してもすべての権限が得られるわけではない
- チャネルの無効化：「連携済み」と表示されていても、それだけでメッセージを実行できるとは判断できません。管理者に有効状態を確認してもらってください。
- スペースへのアクセスと実行：連携によってスペースメンバー、会社の範囲、実行権限の制限を回避することはできません。スペースや実行環境が利用できない場合は、まずアクセス条件を回復してください。
- Agentと機能：Agentの可視性と有効状態、およびワークスペースと関連機能の認可要件を満たす必要があります。連携によってすべてのツールやナレッジベースが自動的に利用可能になることはありません。
6. よくある質問と次のステップ
問題が発生したときに最初に確認すること
- チャネルインスタンスが見つからない：現在の会社、インスタンス名、管理者の設定を確認してください。有効化されていない未連携のインスタンスや、利用可能な連携方式がない未連携のインスタンスは表示されない場合があります。
- 認証ウィンドウが開かない：ブラウザがポップアップをブロックしていないか確認し、許可してから認証をやり直してください。ウィンドウは開いたが認証に失敗した場合は、アカウントとエラーメッセージを確認してください。
- 連携コマンドを送信しても成功しない：正しいボットまたは接続アカウントに送信したか、コマンドが完全で有効期限切れでないかを確認してください。有効期限が切れた場合は新しく取得し、古いコードを繰り返し送信しないでください。
- 連携済みと表示されるがメッセージを実行できない：チャネルが有効か、現在のスペースにアクセスでき実行可能か、選択したAgentが利用可能かを順に確認してください。連携ステータスが示すのはアイデンティティの関連付けだけです。
- 過去の連携にワークスペースがないと表示される：まず個人デフォルトスペースとその実行環境が利用可能であることを確認してから、連携を解除して再連携してください。Google Chatのユーザーは、連携を解除する前に上記の複数インスタンスに関する影響範囲を確認してください。
- スペースやAgentを切り替えられない：まず現在の実行を終了してから、リストにある完全な名前で再試行してください。同名、権限なし、スペースの無効化、実行環境の異常がある場合は、先にそれらに対処する必要があります。
- Google Chatでチャットはできるがネイティブの添付ファイルを送信できない：「ファイルを認証」の入口が表示されているか確認し、認証を完了してください。入口がない場合は、管理者に認証設定を確認してもらってください。