Slack を接続する

Slack Apps を開き、Create an App をクリックします。

From a manifest を選び、接続先のワークスペースを選択します。JSON に切り替え、以下の設定をすべて貼り付けます。アプリ情報を確認して作成を完了します。

{
  "display_information": {
    "name": "HAST Agent",
    "description": "Agent conversations, channel history, public search and files"
  },
  "features": {
    "bot_user": {
      "display_name": "hast-agent",
      "always_online": false
    },
    "app_home": {
      "home_tab_enabled": false,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "agent_view": {
      "agent_description": "Ask your HAST Agent for help with messages, history and files."
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "search:read.public",
        "users:read"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://example.com/slack/events",
      "bot_events": [
        "app_mention",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim"
      ]
    },
    "socket_mode_enabled": false,
    "org_deploy_enabled": false,
    "token_rotation_enabled": false
  }
}

アプリ名と説明は変更できます。https://example.com/slack/events は仮の URL です。AIP のコールバックを取得したら置き換えてください。この URL ではワークスペースのメッセージを受信できません。

Socket Mode がオフになっていることを確認します。ダイレクトメッセージを使う場合は、App Home の Messages Tab を有効にし、App へのメッセージ送信を許可します。

AI agent を選択した場合

AI agent を選んだ場合は、次の画面で Starter agent を選び、アプリ名と接続先のワークスペースを指定して Review Agent をクリックします。上記の Manifest から作成済みの場合、この説明はスキップしてください。

アプリ情報と権限を確認し、Create をクリックします。作成後に App Manifest を開き、上記 JSON の権限とイベントを補ってからインストールに進みます。

OAuth & Permissions を開き、Bot Token Scopes に以下の 22 項目を追加して Install to Workspace をクリックします。

User Token Scopes は空のままにします。

Thinking Steps は既存の chat:write 権限でストリーミングメッセージを作成・更新し、完了後にBot 自身の一時的なステップメッセージを削除します。追加の scope やイベント購読は不要で、上記の完全な JSON に必要な権限が含まれています。以前の App に権限が不足している場合は追加してワークスペースに再インストールし、AIP の Bot Token も更新してください。

Request to Workspace Install と表示された場合は申請を送り、管理者の承認後にインストールを続けます。

申請画面で必要に応じて Reason を入力し、Submit Request をクリックします。申請だけではインストールは完了しません。管理者の承認を待ってから続けてください。

この画面の Redirect URLs はメッセージのコールバックではありません。手順 4 の Event Subscriptions で設定してください。

続いてアプリのインストールページが開いた場合は、Add to Slack をクリックします。すでに認可画面が表示されている場合は、次の手順に進みます。

認可画面で接続先のワークスペースと権限を確認し、Allow をクリックします。scopes を変更した場合は、権限を反映するために再インストールが必要です。公開検索には管理者の承認が必要な場合があります。

OAuth & Permissions に戻り、xoxb- で始まる Bot User OAuth Token をコピーします。User OAuth Token も表示されている場合、そちらは AIP に入力しないでください。

同じ Slack App の Basic Information を開き、App Credentials の Signing Secret 横にある Show をクリックして値をコピーします。同じページの Client Secret、Verification Token と区別してください。

AIP のチャネル画面から新しいチャネルを作成し、Slack を選択します。チャネル名、Bot User OAuth Token、Signing Secret を入力し、保存してコールバック設定に進みます。

作成後に表示されるメッセージコールバック URL を省略せずにコピーし、画面を開いたままにします。次の手順で Slack のコールバック設定を完了してから、画像内の続行ボタンをクリックしてください。

1. Slack App の設定に戻り、Socket Mode がオフであることを確認します。
2. Event Subscriptions を開き、Enable Events をオンにします。
3. AIP のコールバック URL 全体を Request URL に貼り付け、Verified を待ちます。
4. Subscribe to bot events を開き、以下の五つのイベントを確認します。
5. Save Changes をクリックします。再インストールを求められたら実行します。

Slack で Bot をテスト用チャンネルに招待します。参加後、そのチャンネルのメッセージイベントを受信し、権限に応じて履歴を読めるようになります。

AIP に戻り、プラットフォーム設定の完了を確認して次に進みます。有効な Agent を選んで保存してください。後からチャネルメニューの編集画面で Agent を変更することもできます。

Bot が参加しているチャンネルで @Bot こんにちは。何ができますか？ と送信します。@Bot は実際の App へのメンションに置き換えてください。元のチャンネルまたはスレッドに返信が届いたら、続けて質問します。

初期設定では、チャンネルとスレッドで質問するたびにメンションが必要です。ダイレクトメッセージでは不要です。Slack はワークスペースとチャンネルのメンバー権限を使うため、招待コードは必要ありません。

添付ファイルを扱う場合は、Agent のファイル操作権限を書き込み可能なワークスペースに設定し、利用可能な機能でコマンド実行とネットワークアクセスを有効にして保存します。個人情報を含まない小さなファイルを送り、Bot にメンションして読み取りを依頼します。続いてファイルの返信を依頼し、読み取りと送信をそれぞれ確認してください。