チャンネルの設定 - Slack

概要

Slack チャンネルは、ボットトークンとアプトークンで接続されます。これにより、Hermes Agent をチームチャンネル、ダイレクトメッセージ、そして自動化されたタスク通知に導入することが可能です：Slack アプリ管理コンソールでアプリを作成し、権限を設定し、両方のトークンを取得して、LightVela コンソールのチャンネルセクションに貼り付けます。アプリをインストールでき、設定済みのモデル（またはプランに含まれる月次モデルクレジット）があるSlack ワークスペースが必要です。両方のトークンは機密情報であり、公開してはいけません。接続が完了すると、Slack のエージェントは、他のチャンネルと同じペルソナと長期記憶を共有します。

Slack は Bot トークンとアプリトークンを使用して Hermes Agent をチームチャンネル、ダイレクトメッセージ、自動タスク通知に接続します。

このページの内容

• Slack アプリを作成し、ソケットモード、権限、イベントを設定する

• LightVela で Slack の Bot トークンとアプリトークンをバインドする

• Slack のチャンネルやダイレクトメッセージを通じて Hermes Agent とチャットする

手順

1. Slackチャネル設定をLightVelaで開きます

LightVelaの国際サイトにサインインし、My Hermes → Channelを開き、Slackカードを見つけて、+ Connectをクリックします。すると、2つの資格情報が返されます:

• Slack Botトークン: xoxb-で始まります。
• Slack アプリトークン: xapp-で始まります。

2. Slack アプリを作成する

1. オープンSlack APIアプリにサインインしてください。
2. 新しいアプリを作成をクリックします。

3. 最初から作成を選択します。

4. Hermes Agent のようなアプリ名を入力します。
5. Hermes Agent が実行されるワークスペースを選択し、アプリを作成をクリックします。

ワークスペースが見つからない場合は、現在のSlackアカウントがそのワークスペースに属しており、アプリを作成できるか確認してください。

3. アプリトークンを作成する

アプリトークンはSocket Mode WebSocket接続を確立します。connections:writeスコープを含める必要があります。

1. Slackアプリのサイドバーで、設定 → 基本情報 を開きます。

2. アプリレベルのトークンまでスクロールし、トークンとスコープを生成 をクリックします。

3. 認識できるトークン名を入力します。例：HermesSocket。
4. スコープを追加をクリックします。

5. connections:write を検索して選択します。

6. スコープが一覧に表示されていることを確認し、生成をクリックします。

7. 生成された xapp-... トークンをコピーして安全に保管します。コピー後、完了をクリックします。

App トークンを Bot トークンのフィールドに貼り付けないでください。クライアントシークレットやサイニングシークレットは、このトークンの代わりにはなりません。

4. ソケットモード、権限、およびイベントの設定

4.1 ソケットモードを有効にする

1. 設定 → ソケットモード を開きます。
2. ソケットモードを有効にする をオンにします。

ソケットモードは WebSocket を通じて Slack イベントを Hermes Agent に送信します。この設定では、イベント購読のリクエスト URL や OAuth リダイレクト URL は必要ありません。

4.2 Bot トークンスコープを追加する

1. 機能 → OAuth & 権限 を開きます。
2. スコープ → ボットトークンスコープ までスクロールします。
3. OAuthスコープを追加 をクリックします。

必要なインタラクションモードのスコープを追加します:

プライベートチャンネルへのアクセスが必要な場合のみ、2つの groups:* スコープを追加してください。アプリはそれぞれの対象チャンネルにも招待される必要があります。

4.3 アプリホームでのダイレクトメッセージを有効にする

ユーザーが Hermes Agent に直接メッセージできるようにする場合：

1. 機能 → アプリホーム を開きます。
2. タブを表示までスクロールします。
3. メッセージタブを有効にします。
4. ユーザーがメッセージタブからメッセージを送信できるオプションを有効にします。

チャネルのメンションのみを使用する場合、このセクションはスキップでき、im:*スコープとmessage.imイベントは省略できます。

4.4 ボットイベントを購読する

1. 機能 → イベント購読を開きます。
2. イベントを有効にするをオンにします。
3. ボットイベントを購読の下で、ボットユーザーイベントを追加をクリックします。
4. チャネルメンションのためにapp_mentionを追加します。
5. ダイレクトメッセージが有効になっている場合はmessage.imを追加します。
6. 変更を保存をクリックします。

インストール後にスコープやイベントを変更した場合は、OAuth & 権限に戻り、ワークスペースに再インストールをクリックします。新しい権限はアプリを再インストールするまで有効になりません。

5. アプリをインストールし、ボットトークンをコピーします

1. 機能 → OAuth & 権限に戻ります。
2. ワークスペースにインストールをクリックします。アプリがすでにインストールされている場合は、ワークスペースに再インストールをクリックします。

3. 要求される権限を確認して、許可をクリックします。

4. SlackがOAuth & Permissionsに戻ったら、ワークスペース用のOAuthトークンを探します。
5. xoxb-で始まるBotユーザーOAuthトークンをコピーします。

署名シークレット、クライアントシークレット、検証トークン、またはxoxp-...ユーザーOAuthトークンを使用しないでください。LightVelaには1つのxapp-...アプリトークンと1つのxoxb-...ボットトークンが必要です。

6. LightVelaでSlackをバインドする

1. My Hermes → Channel → Slackに戻ります。
2. Slack Bot Tokenにxoxb-...トークンを貼り付けます。
3. Slack App Tokenにxapp-...トークンを貼り付けます。
4. トークンが正しいフィールドにあることを確認してから、接続を送信します。
5. Slackカードが接続済みとして表示されるのを待ちます。

7. SlackでHermes Agentをテストする

7.1 チャンネルメンションのテスト

1. Hermes Agentを使用したいSlackチャンネルを開きます。
2. アプリを招待します：

/invite @Hermes Agent

3. ボットに言及するメッセージを送信する:

@Hermes Agent Summarize the key points discussed in this channel today.

ボットは、そのチャンネルに参加した後にのみチャンネルメッセージを受信します。

7.2 ダイレクトメッセージをテストする

1. Slack の アプリ セクションから新しいアプリを開きます。
2. メッセージ タブを選択します。
3. Hello のような短いメッセージを送信します。

成功状態

すべての該当するチェックが通過するとセットアップが完了します:

• LightVela の Slack カードが接続済みとして表示されます。
• Slack アプリは対象のワークスペースにインストールされています。
• Hermes Agent は、アプリが参加しているチャンネルでのメンションに返信します。
• App Home とIMの権限が有効になっている場合、Hermes Agent はダイレクトメッセージに返信します。

サポートされているメッセージタイプ

Slack が接続された後、このチャンネルは以下のメッセージングシナリオに対応します：

FAQ

次のステップ

• チャンネルを設定 - Telegram— 個人の会話とグループ通知

• チャンネルを設定 - WhatsApp— 国際ユーザーとのコミュニケーションおよびカスタマーサービス

• チャネルを設定 - Discord— コミュニティ運営および開発者コミュニティ

• オートメーションを設定— スケジュールされたリマインダーやタスク結果をSlackに送信

• スキルを設定する— Hermes Agent の機能を拡張