メインコンテンツへスキップ
見出し画像

スマホから自分のJarvisに頼む|Hermes AgentとSlackをつなぐ

    どうもTORAです。

    前回のnoteでは、MacにHermes Desktopを入れて、AIのモデルをつなぎ、最初の会話をするところまで書きました(元になったブログ記事もあります)。ただ、あの状態だとJarvisと話せるのはMacの前に座っているときだけです。

    今回は、SlackからJarvisに話しかけられるようにします。Slackにつながると、スマホのSlackアプリから文字で頼んで、返事もSlackで受け取れます。僕もいまはSlackを窓口にして、自分のJarvisを使っています。

    前回と違って、今回はターミナルでコマンドを打つ場面がいくつかあります。上から順番に進められるように書いていきます。


    どういう仕組みでつながるか

    Hermes AgentはSlackとSocket Modeという方式でつながります。外のサービスから自宅のPCへ連絡を届けるには、普通はPCを外から見える状態にしたり、ルーターの設定を開けたりする必要があります。Socket Modeでは、Mac側からSlackへ接続しにいって、その接続を通してメッセージを受け取ります。なので、ルーターのポート開放や公開URLの用意はいりません(Slack公式のSocket Modeの説明)。

    この接続を受け持つのが、HermesのGatewayという仕組みです。流れはこうなります。

    1. スマホやPCのSlackで、Jarvisあてにメッセージを送る

    2. 自宅MacのGatewayがそれを受け取って、Hermesに渡す

    3. Hermesが返事を作って、Slackに返す

    つまり、Macの電源が入っていて、ネットにつながっていて、Gatewayが動いていることが前提です。Macがスリープしていたり電源が落ちていたりすると、メッセージを送ってもすぐには返事が来ません。


    始める前に確認すること

    ターミナルを開いて、次のコマンドを打ってみてください。

    hermes --help
    

    使い方の一覧が出れば準備はできています。command not found と出た場合は、ターミナルからhermesコマンドを使える状態になっていません。Desktop版を入れただけだと、この状態のこともあります。そのときは別の方法でインストールを重ねる前に、Hermes Agentの公式インストール案内を見て、今の環境でCLIを使えるようにする方法を確認してください。この記事は、hermesコマンドがターミナルで動く状態を前提にしています。CLIを新しく入れた場合は、公式案内に沿って hermes model または hermes setup でモデルの接続設定も済ませてから進んでください。

    Slackのワークスペースは、自分ひとりで使う個人用のものを用意してください。会社や仕事で使っているワークスペースにはJarvisを入れないでください。仕事の会話が流れている場所に、自分のAIへの入口を置くことになってしまいます。

    それから、この記事は新しくSlackアプリを作る人向けです。以前にHermes用のSlackアプリを作ったことがある人は、そのアプリの設定をこの手順で上書きしないでください。このあと出てくる「Agent view」という形式は、一度切り替えると元の形式に戻せません(Hermes公式のSlack手順)。

    確認した範囲についても書いておきます。僕の環境ではすでにGatewayが動いていて、Slackから使えています。ただ、新しいアプリを作るところからこの記事の手順を通しでやり直したわけではありません。内容はHermesの公式ドキュメントと、現在のhermesコマンドのヘルプ表示に基づいています。Slackの画面の文言や配置は変わることがあるので、少し違って見えたら近い名前の項目を探してみてください。


    1. Slackアプリの設計図を作る

    Slackのアプリは、必要な権限や受け取るイベントをまとめた「マニフェスト」というファイルから作れます(Slackのマニフェストの説明)。Hermesにはこれを自動で作るコマンドがあるので、それを使います。

    hermes slack manifest --agent-view --name "Jarvis" --write
    

    --agent-view は、新しく作るSlackアプリ向けに公式で指定されている「Agent view」形式で作るためのオプションです。--name "Jarvis" はアプリの名前なので、好きな名前に変えてかまいません。この記事ではJarvisにしています。

    実行すると、次の場所にファイルができます。

    ~/.hermes/slack-manifest.json
    

    次のコマンドで、テキストエディットに中身を表示できます。

    open -e ~/.hermes/slack-manifest.json
    

    2. Slackでアプリを作る

    ブラウザでSlackのアプリ管理ページを開いて、Create New App から From an app manifest を選びます。

    画像

    ①のCreate New Appを押すところから始めます。

    1. アプリを入れるワークスペースを選ぶ(さっき用意した個人用のもの)

    2. テキストエディットで開いたJSONの中身を全部コピーして貼り付ける

    3. 内容を確認して Next、続けて Create を押す

    途中で、このアプリが求める権限の一覧が表示されます。チャンネルのメッセージを読む権限、DMを読む権限、ファイルを読み書きする権限などが並んでいるはずです。ここは読み飛ばさずに目を通してください。何をJarvisに許すかを決めるのは自分です。

    マニフェストから作ると、Socket Modeもオンの状態でアプリができます。ただ、接続に使う鍵はこの時点ではまだないので、次で作ります。


    3. 接続用の鍵を作る(xapp-)

    アプリの設定画面で Basic Information を開いて、下のほうにある App-Level Tokens までスクロールします。

    画像

    このあと開くBasic Information、Install App、App Homeの場所です。①〜③は画面内の場所を示す番号で、本文の見出しの番号とは別です。

    1. トークンを作るボタン(Generate Token and Scopes)を押す

    2. 名前を付ける(hermes-socket など、何でもかまいません)

    3. スコープに connections:write を追加する

    4. Generate を押す

    xapp- で始まる文字列が表示されます。これがSocket Modeで接続するためのApp-Level Tokenです。入力するのは、7のターミナル設定(hermes gateway setup)です。Hermes DesktopのJarvisとの会話欄には貼り付けません。


    4. メッセージタブを確認する

    App Home を開いて、Show Tabs のところを見ます。Messages Tab がオンになっていて、「Allow users to send Slash commands and messages from the messages tab」にチェックが入っているかを確認してください。マニフェストで設定されているはずですが、ここがオフだと、JarvisにDMを送ろうとしたときに送信できない旨の表示が出て、メッセージを送れません。


    5. ワークスペースにインストールする(xoxb-)

    Install App を開いて、Install to Workspace を押します。許可を求める画面が出るので、さっき目を通した権限と同じ内容かを確認してから Allow を押します。

    インストールが終わると、xoxb- で始まる Bot User OAuth Token が表示されます。これも7のターミナル設定(hermes gateway setup)で入力します。

    画像

    インストール済みのアプリでは、Install App のこの欄でボットトークンを確認できます。トークン値は伏せています。

    xapp- はSocket Modeの接続用、xoxb- はボットがメッセージを送るなどの操作をするための鍵です(Slack公式のトークンの説明)。Hermes DesktopのJarvisとの会話欄を含め、AIチャット、noteやSNS、スクリーンショット、Gitのリポジトリには貼らないでください。メモや自分宛てのチャットへ控えず、設定を入力するときにSlackのアプリ管理画面からコピーします。漏らしてしまった場合は、そのトークンの使用を止め、失効と再発行の対応が必要です。App-Level Tokenの管理場所は Basic Information → App-Level Tokens です。ボットトークンの失効・再発行の詳しい操作は、この記事では扱いません。新しいトークンを用意した後はHermes側にも設定し直し、Gatewayを再起動します。


    6. 自分のMember IDを調べる

    Jarvisに話しかけていい人を、自分だけに絞るための準備です。HermesはSlackの表示名ではなく、Member IDという識別番号で相手を見分けます。

    Slackで自分の名前かアイコンをクリックして、プロフィール全体を表示(View full profile)を開きます。⋮(その他)のメニューから、メンバーIDをコピー(Copy member ID)を選ぶと、U から始まる英数字の文字列がコピーされます。


    7. Hermesに設定する

    ターミナルに戻って、対話式の設定を始めます。

    hermes gateway setup
    

    使うサービスを聞かれたらSlackを選んで、聞かれた項目にBot Token(xoxb-)、App Token(xapp-)、自分のMember IDを入力していきます。

    許可するユーザーには、自分のMember IDだけを入れてください。誰でも許可する設定にすると、そのワークスペースにいる人なら誰でも、あなたのMacで動いているJarvisに指示を出せてしまいます。

    対話式の設定ではなく、ファイルに直接書く方法もあります。保存先は次のファイルです。

    ~/.hermes/.env
    

    既存の行は消さず、以下の3項目だけを追加します。同じキーがすでにある場合は、その行の値を更新してください。サンプルの = の右側を、コピーしたトークン全体か自分のMember IDに置き換えます。

    SLACK_BOT_TOKEN=ここをボットトークン全体に置き換える
    SLACK_APP_TOKEN=ここをアプリレベルトークン全体に置き換える
    SLACK_ALLOWED_USERS=ここを自分のMember IDに置き換える
    

    トークンは .env か対話式の設定に入れて、config.yaml には書かないでください。また、この記事はHermesの標準の設定(default)で使っている前提です。profileを切り替えて使っている人は、保存先が変わります。


    8. Gatewayを起動する

    先に、Gatewayがすでに動いていないかを確認します。

    hermes gateway status
    

    ユーザーサービスとしてすでに動いている場合は、設定を読み直すために再起動して、状態を確認します。進行中の会話があれば、応答が終わってから行ってください。

    hermes gateway restart
    hermes gateway status
    

    その場合、次の run は実行しません。別のターミナルで前面起動している場合は、そちらを Control + C で止めてから起動し直します。Gatewayを二重に動かさないようにしてください。

    動いていなければ、まずはターミナルの前面で起動します。

    hermes gateway run
    

    このターミナルを開いている間だけGatewayが動きます。止めたいときは Control + C を押すか、ターミナルを閉じます。最初はこの形で試して、つながることを確かめてから、あとで書く常駐の設定に進むのが分かりやすいと思います。


    9. 最初に話しかけてみる

    話しかけ方はDMとチャンネルの2通りあります。

    DMで話す場合は、Slackのサイドバーのアプリ欄からJarvisを開いて、メッセージタブに書き込みます。DMでは、メンションを付けなくても全部のメッセージに返事をします。

    チャンネルで話す場合は、まずJarvisをそのチャンネルに招待します。ボットは自分からチャンネルに入らないので、使いたいチャンネルごとに招待が必要です。@ の後ろは、実際にSlackに表示されているボットの名前にしてください。

    /invite @Jarvis
    

    チャンネルでは、メンションを付けたメッセージにだけ反応します。

    例えば、最初はこういう害のない頼みごとがいいと思います。

    @Jarvis 日本語で短く自己紹介してください

    返事は、そのメッセージにつながるスレッドに返ってきます。続けて、同じスレッドの中でこう頼んでみます。

    さっきの自己紹介を1文に縮めてください

    スレッドの中で一度会話が始まると、そのスレッドではメンションなしで返事が来るようになります。スレッドの外に書いたメンションなしのメッセージは無視されます。

    ここで話した内容が、別のチャンネルや別のスレッドにそのまま引き継がれるわけではありません。前の話の続きを頼みたいときは、同じスレッドで続けるのが基本です。

    最初の試しでは、何かを止める、権限を変える、ファイルを消す、どこかに投稿する、といった操作は頼まないでください。まずは、メッセージと返事が往復することだけを確認します。

    ここまでできたら、スマホのSlackアプリで同じワークスペースを開いて、同じようにJarvisに送ってみてください。Mac側でGatewayが動いていれば、Macの前にいなくても返事が来ます。


    ターミナルを閉じても動かしておきたいとき

    hermes gateway run はターミナルを閉じると止まります。いつでもスマホから頼めるようにしたいなら、Gatewayをユーザーサービスとして登録して、裏で動かしておけます。

    hermes gateway install
    hermes gateway start
    hermes gateway status
    

    install でユーザーサービスとして登録して、start で起動、status で動いているかを確認します。前面で起動したGatewayがまだ残っているなら、先に Control + C で止めてから進めてください。

    常駐させていても、Macがスリープしたり電源が切れたりすれば返事は来ません。外出先から使いたいなら、Macがスリープしない設定になっているかも見ておいてください。


    つないだあとに気をつけること

    Slackに書いた内容はSlackに残ります。JarvisがクラウドのAIモデルを使っているなら、頼んだ内容はそのAIの提供元にも送られます。仕事の資料や顧客の情報のような、外に出してはいけないものはここに書かないほうがいいです。

    お金の面では、Slack経由にしたからといってAIを無制限に使えるようになるわけではありません。AIの利用は、これまでどおり自分が契約しているモデルの料金や上限の範囲で動きます。Slack側のプランの条件は、使っているワークスペースで確認してください。


    つながらないときに見るところ

    DMでは返事が来るのにチャンネルでは反応しない場合は、まずJarvisをそのチャンネルに招待したか、メンションを付けたかを確認してください。それでも駄目なら、アプリ設定の Event Subscriptions に message.channels(公開チャンネル用)や message.groups(非公開チャンネル用)が入っているかを見ます。

    DMを送ろうとして送信できない旨の表示が出る場合は、4で見た App Home の Messages Tab の設定を確認します。権限やイベントの設定をあとから変えたときは、Install App からアプリを入れ直さないと変更が反映されません。

    何を送っても反応がないときは、ターミナルでGatewayが動いているか、hermes gateway status で見てみてください。Macがスリープしていないかも確認しておくといいです。


    #生成AI #AIエージェント #Slack #HermesAgent #Jarvis #AI活用


     
     
    エンタープライズ系のシステム開発をしているエンジニア。現場でAI駆動開発を実践中。Hermes AgentでAIアシスタント「jarvis」を作って毎日運用しています。海外AIの新情報を日本語で、実務目線で。Grok Botにサブスク代を稼がせる実験も進行中。ギターと革靴が好き。

    あなたへのおすすめ