Slack Bot 連携

任意のエージェントを Slack Bot に接続すれば、チームは Slack の中から直接それを使えます——Bot に DM したり、チャンネルで @ メンションしたり、/issue と入力してアプリを開かずに AACWorkflow イシューを起票したりできます。

Slack は自分のアプリを持ち込む（BYO: bring-your-own-app）モデルを採用しています。ワークスペースの admin が Slack アプリを作成し、自分の Slack ワークスペースにインストールして、そのトークンを AACWorkflow に貼り付けます。エージェントごとに専用の Slack アプリを持つため、同じ Slack ワークスペース内で複数のエージェントがそれぞれ別個に @ メンションできる異なる Bot を持てます。（これは紐づけがスキャンしてインストールするフローである Lark とは異なります。）

セットアップ全体は以下のとおりで、所要時間は約 5 分です。最終的に、AACWorkflow に貼り付ける 2 つのトークンが得られます。

• Bot トークン —— xoxb- で始まります
• App-level トークン —— xapp- で始まります

Slack アプリをセットアップする

1. マニフェストからアプリを作成する

1. https://api.slack.com/apps を開き、Create New App をクリックします。
2. From a manifest を選びます。
3. アプリをインストールする Slack ワークスペースを選びます。
4. YAML タブに切り替え、下記のマニフェストを貼り付けて、内容を確認しアプリを作成します。

display_information:
  name: AACWorkflow
features:
  app_home:
    home_tab_enabled: false
    messages_tab_enabled: true
    messages_tab_read_only_enabled: false
  bot_user:
    display_name: AACWorkflow
    always_online: true
  slash_commands:
    - command: /issue
      description: Create an AACWorkflow issue
      usage_hint: "[title]"
oauth_config:
  scopes:
    bot:
      - app_mentions:read
      - channels:history
      - groups:history
      - im:history
      - mpim:history
      - chat:write
      - reactions:write
      - users:read
      - commands
settings:
  event_subscriptions:
    bot_events:
      - app_mention
      - message.im
      - message.channels
      - message.groups
      - message.mpim
  interactivity:
    is_enabled: false
  org_deploy_enabled: false
  socket_mode_enabled: true
  token_rotation_enabled: false

このマニフェストは AACWorkflow が必要とするものをすべて設定するので、手作業で何かを設定する必要はありません。

OAuth リダイレクト URL はありません。BYO は OAuth を使わないからです。

2. アプリをインストールして Bot トークンをコピーする

1. アプリの左ナビで Install App（または OAuth & Permissions）を開きます。
2. Install to Workspace をクリックして承認します。
3. Bot User OAuth Token をコピーします——xoxb- で始まります。これがあなたの Bot トークンです。

3. App-level トークンを作成する

app-level トークンは Socket Mode 接続を認可します。これはコンソールでしか作成できません（OAuth の一部ではありません）。

1. Basic Information → App-Level Tokens を開き、Generate Token and Scopes をクリックします。
2. 任意の名前を付けます。
3. Add Scope をクリックし、リストから connections:write を選びます（これはピッカーなので、入力せずに選択してください）。
4. Generate をクリックし、トークンをコピーします——xapp- で始まります。これがあなたの App-level トークンです。

4. AACWorkflow で接続する

1. Agents → あなたのエージェント からそのエージェントを開き、Integrations タブ（または左サイドバーの Integrations 区画）を開きます。
2. Connect Slack をクリックします。
3. Bot トークン（xoxb-）と App-level トークン（xapp-）を貼り付け、Connect をクリックします。
4. エージェントに Connected to Slack と表示されます。Bot はこれで、自身の Socket Mode 接続を通じて待ち受けています。

この連携でできること

Bot を使う（メンバー）

最初のメッセージ：アカウントを紐づける

初めて Bot を @ メンションするか DM すると、Bot は アカウントを紐づける プロンプトで返信します。リンクをタップして AACWorkflow にサインインすると、あなたの Slack アイデンティティがあなたの AACWorkflow メンバーシップに紐づきます——これによって、エージェントがあなたとして振る舞えるようになります（たとえば /issue はあなたの名義でイシューを起票します）。このリンクは使い切りで、約 15 分で失効します。新しいものが必要なら、もう一度 Bot にメッセージを送るだけです。

紐づけは Slack ワークスペースごとに一度だけです。 同じ AACWorkflow ワークスペースが 1 つの Slack ワークスペースで複数の Bot を運用している場合（エージェントごとに 1 つのアプリ）、最初の Bot で紐づけを済ませれば、残りはその紐づけを自動的に再利用し、再びプロンプトは出ません。（再度の紐づけが必要なのは、別の Slack ワークスペースにある Bot、または 別の AACWorkflow ワークスペースに接続された Bot だけです。）

対話と /issue

• チャンネルで —— Bot は自動では参加しません。一度 /invite @your-bot を実行してから、@your-bot <あなたのメッセージ> とします。フォローアップのたびに再度メンションしてください（Bot は自分をメンションしたメッセージだけを読みます）。
• DM で —— Slack サイドバーの Apps 区画から Bot を開いて直接メッセージを送ります。メンションは不要です。
• イシューを起票する —— /issue スラッシュコマンドを使います（例: /issue ログインのリダイレクトが Safari で壊れている）。自然言語で説明すれば、エージェントがタイトルと構造化された説明を書いて起票してくれます。チャンネルでも DM でも使え（@ メンション不要）、まず本人にだけ受付の返信をし、イシューが作成されたら AACWorkflow の通知が届きます。初回のユーザーには、まずアカウント連携の使い切りリンクが届きます。

管理と切断

ワークスペース全体の管理は Settings → Integrations にあります。

• Connected bots は、ワークスペース内のすべての Bot と、それぞれが紐づくエージェントを一覧表示します（すべてのメンバーから見えます）。
• Disconnect は owner / admin 専用 です。切断すると Bot は Slack メッセージの受信を停止し、その接続が破棄されます。インストール記録は監査のために保持され、あとで再接続できます。

権限

• 接続 / 切断 にはワークスペースの owner または admin が必要です。
• Bot との対話 には、Slack アイデンティティを紐づけたワークスペースメンバーであることが必要です。それ以外の人は一律に破棄されます。
• 破棄されたメッセージの本文が保存されることはありません——監査のために破棄理由だけが記録されます。

次に

• Chat 連携 — チャンネルエンジン、セッション、認可の仕組み
• エージェント · Chat · イシュー