Slack との統合

Slack は、ユーザー同士のコラボレーションを支援するクラウド・ベースのメッセージング・アプリケーションです。

アクションを作成した後でアシスタントを Slack と統合できます。

統合すると、サポートするようにアシスタントを構成したイベントに応じて、アシスタントは、ダイレクト・メッセージで尋ねられた質問、またはアシスタントが直接言及されているチャネルで尋ねられた質問に応答できます。

AIアシスタント、Slack、Db2を使ったSlackbotの作成方法については、ソリューション・チュートリアル「Build a database-driven Slackbot」で例と手順を紹介している。

開始前に

Slackとアシスタントを統合するには、Slackアプリと必要な役割と権限が必要です：

ロール 許可
ワークスペースまたは '
組織所有者		 情報 '
を表示する 情報 '
アクションを実行する

slackアプリを作成するには、クイックスタートをご覧ください：ワークフローを開始する。

ロールとパーミッションの詳細については、Slack-Getting startedを参照してください。

Slack 統合の追加

  1. 左メニューの統合アイコン（統合アイコン）をクリックして統合ページに移動します。

  2. 「追加」 (Slack タイル上) をクリックします。

  3. そして、もう一度Addをクリックする。

使用を開始する

Slackの設定には4つのステップがある：

  • Slackボットを設定する
  • watsonx AssistantをSlackに接続する
  • Slackボットを設定する
  • アシスタントをつなぐ

Slackボットを設定する

  1. SlackウェブサイトのYour Appsページにアクセスし、使いたいアプリをクリックするか、新しいアプリを作成します。

watsonx AssistantをSlackに接続する

  1. Slackアプリの設定ページで、「基本情報」タブを開き、「アプリ認証情報」セクションまでスクロールダウンします。

  2. 認証トークンをコピーし、アシスタントの設定ページに貼り付けます。

  3. Slackアプリの設定ページで、Features>OAuth & Permissonsにi進み、Bot Token Scopesセクションまでスクロールダウンします。

  4. Add an OAuth Scopeをクリックし、以下のスコープを選択します：

    • app_mentions:read
    • chat:write
    • im:history
    • im:read
    • im:write

  5. ワークスペースの OAuth トークン] セクションまでページをスクロールして、[ワークスペースにアプリをインストール] をクリックし、[許可] をクリックします。

    OAuth & Permissionsページにリダイレクトされます。

  6. アシスタントの設定ページに、ボットユーザーのOAuthアクセストークンをコピーして貼り付けます。

  7. 「次へ」をクリックして先に進みます。

Slackボットを設定する

  1. 生成されたリクエスト URL をコピーする。

  2. Slackアプリの設定ページで、「Features（機能）」＞「Event Subscriptions（イベント購読）」と進み、「Enable Events（イベントを有効にする）」のトグルを「on切り替える。

  3. リクエスト URL の下に URL リンクを貼り付けます。

    リクエスト URL の横に緑色のチェックマークが表示されるまで待ちます。

  4. 下にスクロールし、「ボットイベントを購読する」をクリックします。

  5. 購読したいイベントタイプを選択します。 次のタイプから少なくとも 1 つ選択する必要があります。

    • message.im: ダイレクト・メッセージ・チャネルに投稿されるメッセージ・イベントを listen します。

    • app_mention: アプリまたはボットに言及するメッセージ・イベントのみを listen します。

      太字フォントの app_mention エントリーではなく、通常フォントの app_mention エントリーを選択してください。

  6. /「変更の保存」をクリックします。

  7. アシスタントのセットアップページで、「Next（次へ）」をクリックします。

アシスタントをつなぐ

  1. Slackアプリの設定ページで、「Features（機能）」＞「AppHome」と進み、「App Display Name（アプリ表示名）」の横にある「Edit（編集）」をクリックします。

  2. 変更したらSaveをクリックします。

  3. トグルを'onに切り替える。

  4. タブの表示」セクションに移動し、「メッセージ」タブのトグルを「on」に切り替える。

  5. ユーザーがメッセージタブからSlashコマンドとメッセージを送信できるようにする]チェックボックスをオンにします。

  6. Slackアプリにボタン、メニュー、曖昧さ解消オプションを表示するサポートを追加したい場合は、以下の手順を実行します：

    1. インタラクティブ＆ショートカット」タブに移動し、機能を有効にする
    2. テキスト入力フィールドに URL を入力してください。
    3. /「変更の保存」をクリックします。

  7. アシスタントのセットアップページで、［完了］をクリックします。

認証に必要な'tokenフィールドが変更された場合、関連するフィールドのすべての入力を再度入力し、検証する必要があります。

アクションに関する考慮事項

アクションに追加したリッチレスポンスは、以下の例外を除いてSlackチャンネルに表示されます：

  • ライブエージェントに接続します：この応答タイプは無視される。

  • Option: この応答タイプでは、ユーザーが選択できるオプションのリストが表示されます。

    • ユーザーが選択肢の一つをクリックすると、既存の選択項目は消え、ユーザーの選択によって生成されたユーザー入力に置き換わる。 1つのレスポンスに複数のレスポンスタイプを含める場合は、レスポンスとユーザー入力の混在による混乱を避けるため、オプションのレスポンスタイプを最後に配置する必要があります。

    • オプションをドロップダウン・リスト形式で表示する場合は、各オプションの値の長さが 75 文字以下でなければなりません。 リストに5つ以上のオプションが含まれる場合、ドロップダウンリストに表示されます。

アシスタントとのチャット

アシスタントとチャットを開始するには、以下の手順を実行します。

  1. Slack を開き、アプリに関連するワークスペースに移動します。
  2. 「アプリ」セクションで作成したアプリケーションをクリックします。
  3. アシスタントとチャットします。

ウェルカム・アクションは Slack 統合では処理されません。 ウェルカム・メッセージは、アシスタント・プレビューとは異なり Slack チャネルには表示されません。 これがここからトリガーされない理由は、welcome 特殊条件を持つノードが、ユーザーによって開始されたダイアログ・フローではスキップされるためです。 Slack は、ユーザーが会話を開始するのを待ちます。

現行セッションのアクション・フローは、60 分間 (ライト・プランおよび標準プランの場合は 5 分間) 何の操作も行われないと再開されます。 つまり、ユーザーがアシスタントとの対話を停止し、60 分 (または 5 分) 経過すると、以前の会話中に設定されたコンテキスト変数の値はすべてヌルに設定されるか、デフォルト値に戻されます。