メインコンテンツまでスキップ

チャンネル管理

最終更新 2026/10/06

閲覧ナビゲーション​

所属する目次:チャネルと統合。

検索キーワード:Channel management、チャネル設定、プラットフォーム認証情報、メッセージ権限、イベントサブスクリプション。

具体的な操作手順は以下を参照してください。

このドキュメントでは、Agentic Engineにおけるチャネルの接続手順を中心に説明します。このドキュメントを参考に、サードパーティチャネルとAgentサービスの統合をすばやく完了し、メッセージの受信、ユーザーとのやり取り、チャネル通信機能を連携させることができます。

チャンネル管理で解決できること:チームのために外部チャットの入口を一元的に接続・管理し、チャネルインスタンスとメッセージ振り分けを設定して、業務リクエストを適切なAgentまたはTeamに渡せるようにします。管理者はプラットフォームアプリとチャネルの設定を担当し、利用者は自分の外部アカウントを別途連携します。チャネルを作成しても、すべてのメンバーの連携が代わりに完了するわけではありません。

対象読者:システム管理権限を持つ管理者。管理範囲は現在の会社です。チャネルの入口が表示されない場合や、機能が有効になっていないと表示される場合は、まずシステム管理者に連絡し、権限、サンドボックス、チャネル機能が有効になっているかを確認してください。

チャネルでは、Feishu/Larkテナント、Slack Workspace、Discord Server、DingTalk企業、WeCom企業、またはMattermost Siteごとに「グループチャットのメッセージ振り分け」を設定できます。管理者は既定のAgent/Teamを設定し、呼び出しコマンドやキーワードによってグループチャットのタスクをさまざまな機能に振り分けることができます。各プラットフォームで必要な権限、設定手順、ユーザーコマンドについては、上記の該当するサブマニュアルを参照してください。

メッセージ振り分けにおける「チャットスペース」は外部プラットフォームの接続範囲を指し、AEのワークスペースではありません。管理者によるグループチャット振り分けの設定と、ユーザーが通常のダイレクトメッセージでワークスペースやAgentを選択する設定は別のものであり、互いに代わりにはなりません。

警告

接続時の必須チェック:アプリの認証情報を入力するだけでは不十分です。該当するチャネルのサブドキュメントに従って、メッセージとファイルの権限、グループチャットのイベントサブスクリプション、インタラクションのコールバック、およびバージョンの公開または再インストールを完了してください。完了していない場合、「ダイレクトメッセージは正常だが、グループチャットでは呼び出せない」「テキストは正常だが、質問フォーム、画像、生成ファイルが失敗する」といった問題が発生する可能性があります。

インスタンスとアイデンティティ:同じ企業で複数のチャネルインスタンスを設定できますが、同じBotアイデンティティを同じ実行環境で重複して設定することはできません。また、同じBotを複数のクラスター環境に同時に接続しないでください。重複消費、重複返信、会話のずれ、キャンセルコマンドが誤ったタスクに作用するなどの問題が発生する可能性があります。

システム管理でチャネルを設定する​

管理者は「システム管理 → エージェント 管理者 → チャンネル管理」で、Feishu、Slackなどのチャネルインスタンスを管理します。各プラットフォームの認証情報、権限、コールバック、公開手順は、上記の該当プラットフォームのマニュアルに従って完了してください。

新規作成と検証

  1. 「新規チャンネル」をクリックし、チームで識別しやすいチャンネル名を入力して、チャンネルタイプを選択します。同じプラットフォームに複数のインスタンスがある場合は、区別できる名前を使用してください。チャンネルタイプは作成後に変更できません。
  2. 選択したプラットフォームに応じて必要な認証情報を入力し、デフォルトモデルを設定します。必要に応じて「チャネル入力の追加説明」を入力してから保存します。デフォルトモデルでは、会社デフォルトやチャネル利用者の個人デフォルトを参照するか、リストから利用可能なモデルを選択できます。これはAgentの選択やグループチャット振り分けの設定ではありません。
  3. インスタンスが有効になっていることを確認し、プラットフォームに応じて認証情報の検証または連携を完了します。対応するインスタンスでは、「メッセージ振り分け」に入る際に検証状態が先にチェックされます。Zoom Team Chatでは「認証情報を検証」を使用できます。WhatsAppでは、保存して有効にした後、管理者がQR コードで共有ボットアカウントを連携する必要があります。
  4. 設定が完了したら、利用者にチャネルの概要と連携に従って個人アカウントの連携を完了してもらい、実際に必要なダイレクトメッセージ、グループチャット、ファイルのやり取りを検証します。認証情報の検証に成功しても、すべての権限、イベントサブスクリプション、インタラクションのコールバックが正しく設定されているとは限りません。

グループチャットのメッセージ振り分けを設定する

対象のインスタンスで「メッセージ振り分け」を開き、設定する「チャットスペース」を選択します。グループチャット振り分けを有効にするかどうかと、既定で使用するAgent/Teamを設定し、必要に応じて呼び出しコマンドやキーワードで選択できるAgent/Teamを追加します。追加する各ターゲットには呼び出しコマンドの入力が必要で、キーワードは任意です。保存する前に、画面に表示される名前の重複、形式、数に関する問題を解消してください。

設定可能なチャットスペースが表示されない場合は、該当プラットフォームのマニュアルに従って権限、インストール、グループチャットのイベント設定を確認してから、ここに戻って確認または再検証してください。同じBotのインスタンスを重複して作成することで設定の問題を回避しようとしないでください。

メンテナンス時の注意

  • シークレットを編集する際、「空欄で変更なし」と表示されているフィールドは再入力する必要はありません。シークレットが再表示されないことを、設定が失われたと誤解しないでください。
  • 重要な認証情報を変更すると、元の検証結果とグループチャット振り分けの入口が無効になる場合があります。「キー設定変更の確認」が表示されたら、まず影響を受けるユーザーを確認してください。確定後、該当するユーザーは再連携が必要になります。また、認証情報の検証とグループチャット振り分けの状態を再確認してください。
  • 無効化すると、そのインスタンスは新しいメッセージの受信と処理を停止します。削除すると、さらにそのインスタンスのユーザー連携が解除され、グループチャット振り分けの設定も削除されます。削除時には元に戻せない旨の確認が表示されるため、先に影響範囲を確認してください。削除を通常の無効化の代わりに使わないでください。

チャンネル管理

新規チャンネル(Feishu)

新規チャンネル(Slack)

このページは役に立ちましたか?