EMQXエージェントをSlackに接続する
Slackコネクターを使用すると、EMQXエージェントは会話の読み取りや検索、メッセージの送信および管理、チャンネルやメンバーの操作、ファイルのアップロード、リアクションの追加、リマインダーの作成が可能です。アラート通知、コラボレーション、運用フォローアップのワークフローに利用できます。
一般的なユースケース
- 異常検知後に運用チャンネルへアラートを送信する。
- 未読メッセージやメッセージスレッドの要約を作成する。
- インシデント用のチャンネルを作成し、対応者を招待する。
- 生成したレポートをアップロードし、メッセージスレッドに追加する。
チャットプロンプトの例：
ops-slackコネクターを使用して、エージェントが重大な異常を確認した際にdevice-alertsチャンネルに簡潔なアラートを投稿してください。デバイスIDと推奨される対応を含めてください。前提条件
コネクターを追加する前に、以下を準備してください：
- 必要なワークスペースにアクセスできるSlackアカウント
- メッセージ、チャンネル、ファイル、リアクション、リマインダー、ユーザー操作の認可権限
- ワークフローでアクセスが必要なプライベートチャンネルのメンバーシップ
Slackコネクターの追加
左側のナビゲーションメニューで Connectors をクリックします。
Available タブで Slack を見つけて Add をクリックします。
Add Connector パネルで Type が Slack に設定されていることを確認します。
説明的な Name を入力し、Confirm をクリックします。
EMQXエージェントはコネクターを Unauthorized ステータスで追加し、認証ダイアログを開きます。
認証ダイアログでComposioがSlackにリダイレクトするのを待ちます。
Slackの認証ページで、コネクターがアクセスする Workspace を選択します。
Composioが要求する権限を確認し、Allow をクリックします。
ComposioがSlackへの接続に成功したことを確認し、EMQXエージェントに戻るのを待ちます。
Added タブで Authorization successful メッセージが表示され、コネクターのステータスが Authorized になっていることを確認します。
重要なお知らせ
SlackはComposioアプリがSlack Marketplaceで承認されていないと表示する場合があります。要求されている権限と組織のアプリ認可ポリシーをよく確認してください。
Slackコネクターの編集
- Added タブでSlackコネクターの編集アイコンをクリックします。
- Edit Connector パネルで Name を更新します。
- Confirm をクリックします。
編集できるのは Name のみです。Type とSlack認証は Edit Connector パネルで変更できません。この制限はすべてのMCPコネクターに適用されます。
サポートされているツール
メッセージおよび会話コンテンツ
| ツール | アクセス | 説明 |
|---|---|---|
SLACK_SEND_MESSAGE | 書き込み | チャンネル、ダイレクトメッセージ、グループメッセージ、スレッドにメッセージを送信します。 |
SLACK_UPDATES_A_SLACK_MESSAGE | 書き込み | 既存のSlackメッセージを更新します。 |
SLACK_DELETES_A_MESSAGE_FROM_A_CHAT | 破壊的 | Slackメッセージを削除します。 |
SLACK_SEARCH_MESSAGES | 読み取り | チャンネル、ユーザー、日付、内容のフィルターを指定してワークスペースのメッセージを検索します。 |
SLACK_FETCH_CONVERSATION_HISTORY | 読み取り | チャンネルまたは会話のタイムラインからメッセージを取得します。 |
SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION | 読み取り | 親メッセージとそのスレッド返信を取得します。 |
SLACK_LIST_UNREAD_CHANNEL_MESSAGES | 読み取り | 認可ユーザーのチャンネル内の未読メッセージを取得します。 |
SLACK_SCHEDULE_MESSAGE | 書き込み | メッセージの予約送信を設定します。 |
チャンネルおよびメンバー
| ツール | アクセス | 説明 |
|---|---|---|
SLACK_LIST_ALL_CHANNELS | 読み取り | アクセス可能なパブリックチャンネル、プライベートチャンネル、ダイレクトメッセージ、グループメッセージを一覧表示します。 |
SLACK_RETRIEVE_CONVERSATION_INFORMATION | 読み取り | チャンネルまたは会話のメタデータを取得します。 |
SLACK_RETRIEVE_CONVERSATION_MEMBERS_LIST | 読み取り | チャンネルまたは会話のメンバー一覧を取得します。 |
SLACK_INVITE_USERS_TO_A_SLACK_CHANNEL | 書き込み | チャンネルにユーザーを招待します。 |
SLACK_CREATE_CHANNEL | 書き込み | パブリックまたはプライベートチャンネルを作成します。 |
SLACK_SET_THE_TOPIC_OF_A_CONVERSATION | 書き込み | 会話のトピックを設定または更新します。 |
SLACK_SET_CONVERSATION_PURPOSE | 書き込み | 会話の目的を設定または更新します。 |
ユーザーおよびアイデンティティ
| ツール | アクセス | 説明 |
|---|---|---|
SLACK_FIND_USER_BY_EMAIL_ADDRESS | 読み取り | メールアドレスでSlackユーザーを検索します。 |
SLACK_RETRIEVE_DETAILED_USER_INFORMATION | 読み取り | ユーザーIDで詳細なユーザーおよびチーム情報を取得します。 |
SLACK_LIST_ALL_USERS | 読み取り | ワークスペースのユーザーとプロフィール情報を一覧表示します。 |
SLACK_RETRIEVE_A_USER_S_IDENTITY_DETAILS | 読み取り | 認可ユーザーおよびワークスペースのアイデンティティを取得します。 |
リアクション、ファイル、リマインダー
| ツール | アクセス | 説明 |
|---|---|---|
SLACK_ADD_REACTION_TO_AN_ITEM | 書き込み | メッセージに絵文字リアクションを追加します。 |
SLACK_UPLOAD_OR_CREATE_A_FILE_IN_SLACK | 書き込み | ファイルをアップロードするか、テキストからファイルを作成し、チャンネルまたはスレッドに共有できます。 |
SLACK_CREATE_A_REMINDER | 書き込み | 認可ユーザーまたは他のユーザーのための一回または定期的なリマインダーを作成します。 |
重要なお知らせ
メッセージ送信、更新、削除、チャンネル作成、メンバー招待、ファイルアップロード、リマインダー作成のツールはSlackワークスペースを変更したりユーザーと通信したりします。書き込み操作の前に送信先を必ず確認してください。
チャットでのコネクターの使用
- チャット入力エリアでコネクターアイコンをクリックします。
- 認可済みの Slack コネクターを選択します。
- プロンプトでエージェントが使用すべき外部リソースと操作を指定します。
- 生成されたエージェント定義を確認し、必要なツールのみが含まれていることを確認します。
権限とデータアクセス
コネクターは認可されたSlackアカウントとワークスペースを使用します。チャンネルメンバーシップ、ワークスペースの役割、アプリ権限、Slack管理者ポリシーがアクセス可能な会話や操作を決定します。
チャットプロンプトやエージェント指示に外部サービスの認証情報やアクセストークンを含めないでください。
制限事項
- Slack APIのレート制限およびワークスペースポリシーが適用されます。
- プライベートチャンネルは認可アカウントおよびインテグレーションがアクセス権を持つ場合のみ利用可能です。
- ファイルアップロード、メッセージ履歴、検索結果はSlackプランおよび保持設定によって制限される場合があります。
トラブルシューティング
| 症状 | 解決策 |
|---|---|
| コネクターが Unauthorized のまま変わらない。 | 認証を再試行し、アカウントがEMQXエージェントへのアクセス権を付与できるか確認してください。 |
| ツールが権限エラーを返す。 | 認可アカウントの対象リソースおよび操作へのアクセス権を確認してください。 |
| 必要なツールが利用できない。 | ツールがこのコネクターでサポートおよび承認されているか確認し、チャットで再度コネクターを選択してください。 |
| リクエストが断続的に拒否される。 | 外部サービスのステータス、APIクォータ、レート制限、アカウントプランを確認してください。 |